SuperAPI AI 工具集

harvest-mcp-server

Harvest MCP Server 是一个非官方的模型上下文协议(MCP)服务器,用于将 Harvest 时间追踪 API v2 集成到兼容 MCP 的应用中。它提供 40 多个(官方简介称 60 多个)工具,覆盖客户、项目、时间条目、发票、费用、估算和报告等主要端点,使用 TypeScript 与 Zod 校验实现类型安全,并具备异步、限流、自动重试和结构化日志等特性。适用于通过 Claude Desktop 等 MCP 客户端查询或管理 Harvest 账户中的时间追踪与项目财务数据。

访问官网

工具介绍

用途

Harvest MCP Server 是一个非官方的第三方 Model Context Protocol(MCP)服务器,用于将 Harvest 时间追踪 API v2 接入兼容 MCP 的应用程序。它并非 Harvest 或 Forecast 官方项目,也未获得其背书或赞助。

主要能力

该服务器宣称提供 40 多个(官方简介另称 60 多个)工具,覆盖 Harvest API 的主要端点。根据仓库列出的工具,功能可分为:

  • 时间追踪:列出、获取、创建、更新、删除时间条目;启动、停止、重启计时器。
  • 项目与任务管理:管理项目、任务以及项目任务分配,包括列表、创建、更新、删除。
  • 客户与用户管理:管理客户和账户用户,包括当前用户信息。
  • 费用与财务:管理费用、费用类别、发票、估算和报告。
  • 报告:生成时间报告、费用报告、项目预算报告和未开票报告。

项目特性包括:完整 TypeScript 支持与 Zod 校验、异步/await 和限流、单元/集成/契约测试、结构化日志、指数退避自动重试,并兼容 Claude Desktop 等 MCP 客户端。

使用方式

使用前需要:Harvest 账户并启用 API 访问权限,以及一个支持 MCP 的客户端(例如 Claude Desktop)。

获取 Harvest API 凭据:进入 Harvest → Settings → Developers → Personal Access Tokens,创建新令牌,并记录 Account ID(可在 URL 或设置中查看)。然后在 MCP 客户端中配置该服务器,即可在支持 MCP 的客户端中使用上述工具。

仓库还提供环境配置说明,并列出 API 要求:需遵守 Harvest API 服务条款和速率限制(每 15 秒 100 次请求)。

适用场景

适用于通过 MCP 客户端以自然语言方式查询或管理 Harvest 中的时间追踪和项目财务数据,例如查看本周时间条目、启动任务计时器、统计项目工时、管理项目与客户、生成费用和发票报告等。

限制

这是非官方第三方集成,与 Harvest 或 Forecast 无关联、背书或赞助。需要用户自行拥有 Harvest 账户并获取 API 访问权限,且必须遵守 Harvest API 服务条款和速率限制。具体安装和配置步骤、价格或收费信息暂未提供。