Worsoft Daily MCP

这个 MCP 用来让模型通过 Worsoft 后端接口读取日报、获取日报详情、收集月报总结素材，并提交日报或月报。

已对齐的现有接口

• 登录：POST /auth/oauth/token
• 当前用户：GET /admin/user/info
• 日报查询：GET /hr/HrReportDaily/page
• 日报详情：GET /hr/HrReportDaily/{id}
• 新增日报/月报：POST /hr/HrReportDaily
• 修改日报/月报：PUT /hr/HrReportDaily
• 当前时间段任务：GET /hr/HrReportDaily/getTaskByExecuteUserId

前端开发代理里的 /api 已被折叠进 WORSOFT_BASE_URL，默认值是 https://saas.link-work.com.cn/api。

配置

推荐在 MCP 客户端配置环境变量，不要把账号密码写进仓库。

{
  "mcpServers": {
    "worsoft-daily": {
      "command": "node",
      "args": ["E:\\project\\worsoft-daily-mcp\\src\\server.js"],
      "env": {
        "WORSOFT_BASE_URL": "https://saas.link-work.com.cn/api",
        "WORSOFT_USERNAME": "你的用户名",
        "WORSOFT_PASSWORD": "你的密码",
        "WORSOFT_PLATFORM": "pc_saas",
        "WORSOFT_VERSION": "LT",
        "WORSOFT_BASIC_AUTH": "Basic cGlnOnBpZw=="
      }
    }
  }
}

也可以复制 .env.example 为 .env 后在本目录运行，但不要提交 .env。

工具

• worsoft_login：登录并缓存 token。
• worsoft_get_user_info：获取当前登录用户。
• worsoft_query_reports：按类型、时间和范围查询汇报。
• worsoft_get_report：获取单条完整汇报详情。注意后端会把当前用户标记为已读。
• worsoft_get_report_tasks：获取指定时间段内当前用户相关任务。
• worsoft_month_summary_source：读取某个月的日报详情，供模型生成月报总结。
• worsoft_submit_report：新增或修改日报、周报、月报。建议先传 dryRun: true 检查 payload。

查询语义

scope 会映射到后端的 sign：

• related -> 0，我提交或我收到
• submitted -> 1，我提交的
• received -> 2，我收到的

reportType 会映射到后端的 reportingType：

• daily -> 0
• weekly -> 1
• monthly -> 2
• all -> 不过滤类型

日期过滤会按前端页面同款逻辑转换成：

• startTime >= startDate
• endTime <= endDate

月报流程建议

1. 调 worsoft_month_summary_source，例如 { "month": "2026-06", "scope": "submitted" }。
2. 模型根据返回的日报详情生成月报正文和下月计划。
3. 调 worsoft_submit_report，reportType 传 monthly，startDate 传当月 1 日，endDate 传当月最后一天。
4. 首次提交先用 dryRun: true，确认后再真实提交。

本地检查

cd E:\project\worsoft-daily-mcp
npm run check