Timecamp MCP Server

🚀 TimeCamp MCP Server

TimeCamp MCP Server 為 TimeCamp 集成提供了一系列實用工具，能幫助用戶更便捷地管理時間記錄。該服務器採用 TypeScript 開發，支持雲端部署，使用 Cloudflare Workers 實現，具有成本低、易使用等特點。

🚀 快速開始

託管版本可通過此鏈接訪問：https://my-mcp-server.timecamp-s-a.workers.dev

✨ 主要特性

• 語言選擇原因：
  • 採用 TypeScript 而非 Python，是因為有官方客戶端、更多可用資源，且支持 Cloudflare Workers。
  • 選擇託管模式而非僅本地部署，是為了方便用戶使用，無需進行安裝操作。
  • 選用 Cloudflare Workers，因其成本低廉且易於使用。
• 提供的工具：
  • 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]

📦 安裝指南

本地運行

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

📚 詳細文檔

將 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 時存在的問題