mcp-broker-work-status
v0.2.0
Published
MCP server for real-estate broker daily work status (login, follow-up, share, attendance, calls)
Maintainers
Readme
@ouhaibing/mcp-broker-work-status
经纪人每日工作状态 MCP Server(可发布到 npm)。面向门店/区域领导,按日期 + 员工姓名聚合:
- 登录、考勤
- 房源跟进(含 实勘 / 钥匙 / 委托、带看、新增)
- 客户跟进(含 新增 / 跟进 / 带看)
- 房源推广、通话呼叫量
本地 SQLite 只存非敏感字段(无手机号、被叫号码)。
安装 / 运行
cd mcps/broker-work-status
npm install
cp .env.example .env # 填入 DJ_THIRD_*
npm run build
npm start发布后:
npx -y @ouhaibing/mcp-broker-work-statusCursor / MCP 接入
环境变量字段对齐 property/backend/config/settings.py 的 dj_third_*。
请勿在文档/仓库中提交真实密钥;从本地 .env 或密钥管理注入,下方仅为占位示例:
{
"mcpServers": {
"broker_work_status": {
"command": "npx",
"args": ["-y", "@ouhaibing/mcp-broker-work-status"],
"env": {
"DJ_THIRD_BASE_URL": "https://s.dingjianyun.com/dingjian/",
"DJ_THIRD_SECRET": "<your-dj-third-secret>",
"DJ_THIRD_CU_ID": "<your-cu-id>",
"DJ_THIRD_USER_ID": "<your-user-id>",
"DJ_THIRD_DC": "<your-dc>",
"DJ_THIRD_TIMEOUT": "30"
}
}
}
}本地 dist:
{
"command": "node",
"args": ["/abs/path/mcps/broker-work-status/dist/index.js"],
"env": { "...": "DJ_THIRD_*" }
}可选:SQLITE_PATH、CACHE_TTL_SECONDS(默认 300)。
组织范围依赖第三方 CU 鉴权上下文;请求体不传 orgId / longNumber。
Tools
| Tool | 说明 |
| --- | --- |
| sync_users | 同步员工主数据 |
| sync_work_status | 同步某日六维快照 |
| get_broker_work_status | date + employeeName 完整报告 |
| list_work_status_by_date | 某日全员列表 |
Skill
领导层 SOP:skills/broker-daily-work-status/SKILL.md
可将该目录复制/软链到项目 .cursor/skills/ 以便 Cursor 自动发现。
开发
npm test
npm run build
npm pack --dry-run日志仅写 stderr,避免污染 MCP stdio。
线上说明
旧包名 @ouhaibing/broker-work-status-mcp 因 npm 元数据异常(tarball 可访问但 package document 404)已弃用,请改用 @ouhaibing/[email protected]+。
