TimeCamp MCP服务器 - 基于Cloudflare Workers，集成TimeCamp工具API管理时间记录

探索

Timecamp MCP Server

TimeCamp MCP服务器是一个基于Cloudflare Workers的托管服务，提供与TimeCamp时间管理工具集成的API功能，包括创建、查询、更新和删除时间记录等操作。

日程管理开发者工具 #时间管理 #云服务 #API集成 #工作流 .TypeScript

评分 : 2分

下载量 : 5.9K

更新时间 : 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 集成提供了一系列实用工具，解决了时间记录和任务管理的问题，让用户能更便捷地进行时间管理和任务跟踪。

🚀 快速开始

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