丰收时间追踪 MCP 服务器

用于与 Harvest 时间追踪 API 进行交互。

https://www.loom.com/share/b611c5d90a454fb2a7eab99ec0dc3d20?sid=edad9a28-1bbb-452c-838d-721bc435908f

功能

此 MCP 服务器提供以下工具以与 Harvest 进行交互：

用户信息

• get_current_user：获取有关已验证用户的信息

时间条目

• list_time_entries：列出时间条目，可选日期筛选
• get_time_entry：通过 ID 获取特定时间条目
• create_time_entry：通过持续时间创建新的时间条目
• create_time_entry_via_start_end：使用开始/结束时间创建时间条目
• update_time_entry：更新现有时间条目
• delete_time_entry：删除时间条目
• delete_time_entry_external_reference：删除时间条目外部引用
• restart_time_entry：重新启动已停止的时间条目
• stop_time_entry：停止正在运行的时间条目

项目和任务

• list_projects：列出所有项目，可选过滤
• list_tasks：列出所有任务，可选过滤

安装说明

先决条件

• Docker
• 带有 API 凭证的 Harvest 账户

安装

适用于 Claude 桌面用户

如果你使用的是 Claude 桌面，则只需将以下配置添加到 MCP 配置文件中：

"harvest": {
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "HARVEST_ACCOUNT_ID",
    "-e",
    "HARVEST_TOKEN",
    "tommcl/harvest-mcp"
  ],
  "env": {
    "HARVEST_ACCOUNT_ID": "YOUR_ACCOUNT_ID",
    "HARVEST_TOKEN": "YOUR_API_TOKEN"
  }
}

注意：你需要安装并运行 Docker Desktop。

凭证：你可以在 Harvest 开发者工具页面 获取你的个人访问令牌 (PAT) 和账户 ID。

选项 1：从 Docker Hub 拉取（适用于其他 MCP 客户）

1. 直接从 Docker Hub 拉取 Docker 镜像：

   docker pull tommcl/harvest-mcp
   

选项 2：本地构建（用于开发）

1. 克隆仓库：

   git clone https://github.com/yourusername/harvest-mcp.git
   cd harvest-mcp
   

2. 构建 Docker 镜像：

   docker build -t mcp/harvest .
   

   然后在你的 MCP 配置中使用 "mcp/harvest" 而不是 "tommcl/harvest-mcp"。

注意：请用实际的 Harvest API 凭证替换示例凭证。你可以在 Harvest 开发者工具页面 获取你的个人访问令牌 (PAT) 和账户 ID。

使用方法

使用 Claude 桌面进行测试。