时间追踪API服务

Harvest MCP Server是一个用于与Harvest时间追踪API交互的服务,提供用户信息获取、时间条目管理以及项目和任务列表功能。

  • by tgmclaughlin
  • Python
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 tgmclaughlin/harvest-mcp

使用说明

收获MCP服务器

用于与Harvest时间跟踪API交互。

https://www.loom.com/share/b611c5d90a454fb2a7eab99ec0dc3d20?sid=edad9a28-1bb-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:列出所有具有可选筛选的任务

安装说明

先决条件

  • 码头工人
  • 获得API证书的帐户

安装

适用于Claude桌面用户

如果您使用的是Claude Desktop,则只需将以下配置添加到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。

凭证:您可以从以下网址获取您的个人访问令牌(PAT)和帐户ID Harvest开发者工具页面.

选项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凭据。您可以从以下网址获取您的个人访问令牌(PAT)和帐户ID Harvest开发者工具页面.

用法

使用Claude Desktop进行测试。