@vat-mcp/daily-report

MCP Server for daily report system（日报 MCP 服务）。

环境变量

| 变量名 | 必填 | 说明 | |----------------|----|---------------------------------------| | SMS_USERNAME | 是 | 登录用户名 | | SMS_PASSWORD | 是 | 登录密码 | | SMS_BASE_URL | 是 | API 服务器地址，如 https://your-domain.com |

安装与配置

方式一：VS Code MCP 配置（推荐）

在 VS Code 的 mcp.json（用户全局：%APPDATA%\Code\User\mcp.json，或工作区：.vscode/mcp.json）中添加：

{
  "servers": {
    "daily-report": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@vat-mcp/daily-report"],
      "env": {
        "SMS_USERNAME": "${input:sms_username}",
        "SMS_PASSWORD": "${input:sms_password}",
        "SMS_BASE_URL": "${input:sms_base_url}"
      }
    }
  },
  "inputs": [
    {
      "id": "sms_username",
      "type": "promptString",
      "description": "SMS 登录用户名"
    },
    {
      "id": "sms_password",
      "type": "promptString",
      "description": "SMS 登录密码",
      "password": true
    },
    {
      "id": "sms_base_url",
      "type": "promptString",
      "description": "SMS API 地址，例如 https://your-domain.com"
    }
  ]
}

方式二：Claude Desktop 配置

在 %APPDATA%\Claude\claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "daily-report": {
      "command": "npx",
      "args": ["-y", "@vat-mcp/daily-report"],
      "env": {
        "SMS_USERNAME": "你的用户名",
        "SMS_PASSWORD": "你的密码",
        "SMS_BASE_URL": "https://your-domain.com"
      }
    }
  }
}

方式三：本地开发

# 克隆项目
git clone <repo-url>
cd mcp-daily-report

# 安装依赖
pnpm install

# 配置环境变量（复制后填入真实值）
cp .env.example .env

# 编译
pnpm build

# 启动 MCP Inspector 调试
pnpm inspect

# 直接启动
pnpm start

.env 文件内容：

SMS_USERNAME=your_username
SMS_PASSWORD=your_password
SMS_BASE_URL=https://your-domain.com

提供的工具

| 工具名 | 参数 | 说明 | |-------------------------|------------------------------------------------------|-----------------------------------| | get_missing_dates | 无 | 查询未填写日报的日期列表 | | get_tasks | 无 | 查询当前用户的工作任务（项目）列表，获取 proposalId | | get_kintai_by_date | date: YYYY/MM/DD | 根据日期查询考勤信息，获取 kintaiId | | get_reports_by_kintai | kintaiId: number | 根据考勤 ID 查询当天已有日报列表 | | submit_daily_report | date, proposalId, workName, workTime, memo | 提交日报（内部自动防重复检查） |

推荐使用顺序

1. get_missing_dates — 查看哪些天未填日报
2. get_tasks — 获取可用项目列表（记录 proposalId）
3. get_kintai_by_date — 查询目标日期的考勤 ID
4. get_reports_by_kintai — 确认当天是否已有日报
5. submit_daily_report — 提交日报

⚠️ proposalId 为必填项，必须从 get_tasks 结果中选取有效值。