Harvest MCP

🚀 丰收时间追踪 MCP 服务器

丰收时间追踪 MCP 服务器用于与 Harvest 时间追踪 API 进行交互，能帮助用户高效管理时间追踪相关业务。

点击查看演示视频

✨ 主要特性

此 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 桌面进行测试。