TimeCamp MCP服務器 - 基於Cloudflare Workers，集成TimeCamp工具API管理時間記錄

探索

Timecamp MCP Server

TimeCamp MCP服務器是一個基於Cloudflare Workers的託管服務，提供與TimeCamp時間管理工具集成的API功能，包括創建、查詢、更新和刪除時間記錄等操作。

日程管理開發者工具 #時間管理 #雲服務 #API集成 #工作流 .TypeScript

評分 : 2分

下載量 : 5.2K

更新時間 : 2025-07-24

打開站點

什麼是TimeCamp MCP Server?

TimeCamp MCP Server 是一個集成了TimeCamp API的MCP（Model Context Protocol）服務器，允許用戶通過自然語言創建、查詢和管理時間記錄。它提供與TimeCamp的深度集成，適用於需要自動化時間跟蹤的場景。

如何使用TimeCamp MCP Server?

您可以通過簡單的提示詞與TimeCamp MCP Server交互，例如‘創建時間記錄’或‘獲取所有任務’。該服務器通過Cloudflare Workers託管，無需本地安裝即可使用。

適用場景

適合需要快速記錄工作時間、管理項目任務以及自動化時間跟蹤的個人和團隊。特別適合遠程工作者、自由職業者和項目管理者。

主要功能

創建時間記錄

根據用戶提供的開始時間和結束時間，自動創建TimeCamp時間條目，並可添加備註和任務關聯。

獲取時間記錄

支持按日期範圍查詢TimeCamp中的時間記錄，方便回顧和統計工作時間。

獲取任務列表

自動從TimeCamp中拉取所有可用的項目和任務，便於用戶選擇合適的任務進行時間記錄。

刪除時間記錄

允許用戶根據時間記錄ID刪除特定的時間條目。

更新時間記錄

可以修改已有的時間記錄，包括時間、備註或任務分配。

優勢

無需本地安裝，直接通過網絡訪問，易於使用。

利用Cloudflare Workers，成本低且部署簡單。

支持與TimeCamp API深度集成，提供豐富的功能。

兼容Claude Desktop等MCP客戶端，提升工作效率。

侷限性

目前不支持OAuth授權，依賴Bearer Token認證。

部分MCP客戶端可能遇到與Cloudflare Workers的兼容性問題。

需要用戶手動配置API令牌，對非技術用戶有一定門檻。

如何使用

獲取API令牌

在TimeCamp中生成API令牌，用於身份驗證。

連接MCP客戶端

在Claude Desktop或其他MCP客戶端中配置TimeCamp MCP服務器地址和API令牌。

發送自然語言指令

使用自然語言描述您的需求，例如‘創建時間記錄’或‘獲取所有任務’。

使用案例

記錄工作時間

用戶提供了多個任務及其完成時間，系統根據這些信息自動生成對應的時間記錄。

獲取今日任務列表

用戶希望瞭解當天的所有TimeCamp任務，以便安排工作。

常見問題

如何獲取TimeCamp API令牌？

為什麼無法連接到MCP服務器？

如何部署到Cloudflare Workers？

如何測試MCP服務器？

🚀 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。