Harvest MCP 服务器

此 MCP（模型上下文协议）服务器提供与 Harvest 时间跟踪和项目管理 API 的集成。它允许 Claude 和其他兼容 MCP 的 AI 助手与您的 Harvest 帐户进行交互，帮助您管理时间条目、项目、客户等。

特征

该服务器提供以下功能：

用户

• 列出用户
• 获取用户详细信息

时间条目

• 列出带有过滤选项的时间条目
• 创建新的时间条目
• 启动/停止计时器
• 查询时间条目详情

项目

• 使用过滤选项列出项目
• 检索详细项目信息

客户

• 列出带有过滤选项的客户端
• 检索详细的客户信息

任务

• 使用过滤选项列出可用任务

设置说明

先决条件

• Python 3.10 或更高版本
• 具有 API 访问权限的 Harvest 帐户
• Harvest API 密钥和帐户 ID

与 Claude Desktop 集成

1. 创建或编辑您的 Claude Desktop 配置文件：
   • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows： %APPDATA%\Claude\claude_desktop_config.json
2. 添加 Harvest MCP 服务器配置：
   { "mcpServers": { "harvest": { "command": "uv", "args": [ "run", "--directory", "change_directory", "harvest-mcp-server.py" ], "env": { "HARVEST_ACCOUNT_ID": "account_id", "HARVEST_API_KEY": "api_key" } } } }
3. 重新启动 Claude Desktop。
4. 通过查找 Claude 界面中的锤子图标来验证集成。

示例查询

连接后，您可以通过以下查询向 Claude 询问您的 Harvest 数据：

• “显示我上周的时间记录”
• “列出我所有正在进行的项目”
• “为项目 [project_id] 和任务 [task_id] 启动计时器”
• “显示所有活跃客户”
• “列出所有可用任务”

定制

您可以修改服务器代码以添加更多功能，或自定义现有工具以更好地适应您的工作流程。服务器使用 FastMCP，只需使用@mcp.tool()装饰器添加新函数即可轻松添加新工具。

故障排除

• API 错误：确保您的 Harvest API 密钥和帐户 ID 正确并具有必要的权限。
• 连接问题：验证您的 Claude Desktop 配置是否具有正确的服务器脚本路径。
• 缺少依赖项：确保您已在 Python 环境中安装了所有必需的包。

安全说明

此服务器需要您的 Harvest API 凭证才能运行。请确保：

• 确保 API 密钥的安全
• 不要分享你的 claude_desktop_config.json 文件
• 考虑使用具有有限权限的专用 API 密钥进行此集成