Harvest MCP Server
2025.03.20
2
Python时间跟踪项目管理开发效率
Harvest MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，用于与 Harvest 时间跟踪和项目管理 API 集成。它允许 Claude 和其他兼容 MCP 的 AI 助手与您的 Harvest 账户交互，帮助您管理时间条目、项目、客户等。
View on GitHub
Overview
基本能力
产品定位
Harvest MCP Server 是一个用于时间跟踪和项目管理的集成服务，旨在通过 AI 助手简化 Harvest 账户的管理工作。
核心功能
- 用户管理：列出用户和获取用户详细信息。
- 时间条目管理：列出时间条目（支持过滤）、创建新时间条目、启动/停止计时器、查询时间条目详情。
- 项目管理：列出项目（支持过滤）、检索详细项目信息。
- 客户管理：列出客户（支持过滤）、检索详细客户信息。
- 任务管理：列出可用任务（支持过滤）。
适用场景
- 通过 AI 助手快速查询和管理 Harvest 账户中的时间条目、项目和客户信息。
- 自动化时间跟踪和项目管理任务，提高工作效率。
- 集成到 Claude 等 AI 助手中，通过自然语言交互完成 Harvest 相关操作。
工具列表
- 用户工具：列出用户和获取用户详细信息。
- 时间条目工具：管理时间条目和计时器。
- 项目工具：查询和管理项目信息。
- 客户工具：查询和管理客户信息。
- 任务工具：查询可用任务。
常见问题解答
- API 错误：确保 Harvest API 密钥和账户 ID 正确且具有必要权限。
- 连接问题：验证 Claude Desktop 配置中服务器脚本路径是否正确。
- 缺少依赖：确保 Python 环境中已安装所有必需的包。
使用教程
使用依赖
- Python 3.10 或更高版本。
- Harvest 账户和 API 访问权限。
- Harvest API 密钥和账户 ID。
安装教程
- 创建或编辑 Claude Desktop 配置文件：
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json -
Windows:
%APPDATA%\Claude\claude_desktop_config.json -
添加 Harvest MCP 服务器配置：
json { "mcpServers": { "harvest": { "command": "uv", "args": [ "run", "--directory", "change_directory", "harvest-mcp-server.py" ], "env": { "HARVEST_ACCOUNT_ID": "account_id", "HARVEST_API_KEY": "api_key" } } } } -
重启 Claude Desktop。
-
通过查看 Claude 界面中的锤子图标验证集成是否成功。
调试方式
- 确保 API 密钥和账户 ID 正确。
- 检查服务器脚本路径是否正确。
- 确保所有依赖包已安装。