ConstructionClock MCP Server

一个本地 Model Context Protocol 服务器，为 Claude Desktop 提供两个 ConstructionClock 工时录入工具。它直接通过 fetch 与 ConstructionClock REST API 通信，无需浏览器自动化。

工具

时间采用 ISO-8601 格式，为 本地时间，不附带时区后缀，例如 2026-08-12T08:00:00（这正是 ConstructionClock 自身发送的格式）。employeeId 会作为 userId 发送给 API。cc_edit_time 也需要 projectId——编辑端点要求传这个字段，而不仅仅是条目 id。

设置

需要 Node.js 18 或更高版本（fetch 已内置）。本机已于 2026-08-13 通过 winget（OpenJS.NodeJS.LTS，Node v24.19.0）安装，依赖也已全部装好。代码检出后如需重新安装依赖：

cd "C:\Users\15049\OneDrive\Desktop\Claude\Tools\ConstructionClock-MCP"
npm install

服务器会相对于其自身所在的目录加载 .env，因此无论 Claude Desktop 从哪个工作目录启动，它都能正常工作。

然后在 .env 中填入你的 token（从 .env.example 复制）：

CC_API_TOKEN=your-real-token

该 token 位于 DevTools 中捕获到的 ConstructionClock 请求的 Authorization 请求头里。

注册到 Claude Desktop

将其添加到你的 claude_desktop_config.json（%APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "constructionclock": {
      "command": "node",
      "args": ["C:\\Users\\15049\\OneDrive\\Desktop\\Claude\\Tools\\ConstructionClock-MCP\\src\\server.js"]
    }
  }
}

重启 Claude Desktop。这两个 cc_* 工具应该就会显现。

端点（已验证）

以下内容于 2026-08-12 从 app.constructionclock.com 实时捕获：

ADD   POST  /api/punches
      { "punches": [ { userId, projectId, uuid, clockedInAt, clockedOutAt } ] }

EDIT  PATCH /api/punch/edit/time
      { id, projectId, date: { dateFrom, dateTo }, uuid }

uuid 由服务器在每次调用时生成。如果 ConstructionClock 将来更改这些接口，你需要修改的一切都在 src/server.js 顶部的 CONFIG 块中。

预算护栏

参见 BUDGET_GUARDRAILS.md——它是对 Claude Desktop 会话长期有效的指示：在新增或编辑工时之前，先检查 JobTread 的预算与实际工时对比情况。