用途
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 服务条款和速率限制。具体安装和配置步骤、价格或收费信息暂未提供。