金大哥 - timecamp-mcp-server MCP 详情

article

README

🚀 TimeCamp MCP Server

TimeCamp MCP Server 为 TimeCamp 集成提供了一系列实用工具，解决了时间记录和任务管理的问题，让用户能更便捷地进行时间管理和任务跟踪。

🚀 快速开始

本 MCP 服务器提供了托管版本，可通过以下链接访问：https://my-mcp-server.timecamp-s-a.workers.dev

✨ 主要特性

语言选择：采用 TypeScript（TS）而非 Python，原因在于官方客户端的支持、丰富的学习资料以及对 Cloudflare Workers 的适配。
部署方式：选择托管部署而非仅本地部署，是为了方便用户使用，无需进行安装操作。
平台选择：选用 Cloudflare Workers，因其成本低廉且易于使用。

📦 安装指南

本地运行

pnpm start

部署

pnpm dlx wrangler@latest deploy
pnpm dlx wrangler@latest tail

测试

npx mcp-remote http://localhost:8787/sse --header "Authorization: Bearer <api_token>"
npx mcp-remote https://my-mcp-server.timecamp-s-a.workers.dev/sse --header "Authorization: Bearer <api_token>"
pnpm dlx @modelcontextprotocol/inspector@latest

💻 使用示例

基础用法

本 MCP 服务器为 TimeCamp 集成提供了以下工具：

add_timecamp_time_entry：创建一个新的时间记录，包含开始时间、结束时间、备注和可选任务。
get_timecamp_time_entries：检索指定日期范围内的时间记录。
get_timecamp_tasks：获取所有可用的 TimeCamp 项目和任务。
delete_timecamp_time_entry：通过 ID 删除特定的时间记录。
update_timecamp_time_entry：更新现有的时间记录（时间、备注或任务分配）。

示例提示

Create Timecamp time entries based on these tasks I did. 
I write tasks by putting -HH:MM, which is the end time for the task, so each time entry should take from end end time of previous entry.
Try to match timecamp task, so first you have to fetch my timecamp tasks.
Note should be single sentence in English with 3-12 words.
Ignore "[minutes:: ...]" as this is estimate.

- [x] -9:43 emails & org [completion:: 2025-06-21]
- [x] -12:10 #tech new version of reports [[(project) XYZ]] [completion:: 2025-06-21]
- [x] -12:58 (evening) Buy shoes + relax [completion:: 2025-06-21] 
- [x] -14:30 relax [completion:: 2025-06-21]
- [x] -15:30 #tech Notifications still not working for one more person from our group [completion:: 2025-06-21]
- [x] -15:40 I don't remember [completion:: 2025-06-21] 
- [x] -17:09 #tech Client - database connection problem [[(process) Technical support]] [minutes:: 15] [completion:: 2025-06-21]
- [x] -17:35 break [completion:: 2025-06-21]
- [x] -19:17 #tech Client [[(project) Client]] [[(process) Technical support]] [minutes:: 10] [completion:: 2025-06-21]	- - [x] -19:21 (evening) Fill timesheet [completion:: 2025-06-21]

📚 详细文档

将 Claude Desktop 连接到您的 MCP 服务器

您可以使用 mcp-remote 代理从本地 MCP 客户端连接到远程 MCP 服务器。要从 Claude Desktop 连接到您的 MCP 服务器，请按照 Anthropic 的快速入门指南操作，在 Claude Desktop 中，转到“设置”>“开发者”>“编辑配置”。使用以下配置进行更新：

{
  "mcpServers": {
    "timecamp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://my-mcp-server.timecamp-s-a.workers.dev/sse", // 或者 http://localhost:8787/sse
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <auth-token>"
      }
    },
    "timecamp_url": { // 如果 MCP 客户端支持 URL
      "url": "https://my-mcp-server.timecamp-s-a.workers.dev/sse",
      "headers": {
        "Authorization": "Bearer <auth-token>...."
      }
    },
  }
}

重启 Claude，您应该会看到这些工具可用。如果您使用的是 MacOS 版 Claude Desktop 遇到“Server transport closed unexpectedly”问题，请参考 https://github.com/modelcontextprotocol/servers/issues/1748#issuecomment-2896004925。

🔧 技术细节

尚未实现的功能

Oauth 授权（https://github.com/huanshenyi/mcp-server-bearer-auth/tree/main）
解决 Cloudflare Workers 不使用接收到的授权标头问题后，MCP 在 Cursor 中使用 URL 时出现的问题

timecamp-mcp-server