【技术文档摘要】：

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] 的计时器"
• "显示所有活跃的客户"
• "列出所有可用的任务"
• "获取我本月未提交的工作表"
• "显示用户 [user_id] 的未提交时间条目"

自定义

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

故障排除

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

安全注意事项

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

• 保护好您的 API 密钥
• 不要分享您的 claude_desktop_config.json 文件
• 考虑为此集成使用具有有限权限的专用 API 密钥