Harvest 自然语言时间记录 MCP 服务器

一个 MCP 服务器，允许你使用自然语言记录 Harvest 时间条目，包括对请假请求的特殊处理。该服务器通过理解自然语言输入并自动处理常见的场景（如请假请求）使时间跟踪更加直观。

功能

• 🗣️ 自然语言时间条目解析
• 🏖️ 特殊请假请求处理（例如，“我今天病了”）
• ⏰ 可配置的工作日时长
• 🌍 时区支持
• 🎯 自动项目和任务匹配
• 📅 智能日期解析（今天、昨天等）

前提条件

• 已安装 Node.js
• 一个 Harvest 帐户
• 来自 Harvest Developer Tools 的个人访问令牌
• 帐户 ID（与你的令牌在同一页面显示）

安装

安装

1. 安装 Claude 桌面应用程序

2. 克隆此存储库：

git clone https://github.com/adrian-dotco/harvest-mcp-server.git
cd harvest-mcp-server

3. 安装依赖项并构建：

npm install
npm run build

4. 运行设置脚本：

node build/setup.js

5. 按照提示输入你的：

   • Harvest 个人访问令牌（来自 https://id.getharvest.com/developers）
   • Harvest 帐户 ID
   • 标准工作日时长（默认：7.5）
   • 时区（默认：Australia/Perth）

6. 重启 Claude 桌面应用程序

就这样！你现在可以在 Claude 中使用自然语言时间跟踪了。

保持更新

要更新到最新版本：

git pull
npm install
npm run build

设置脚本会将 Claude 配置为使用你本地构建的服务器，因此你拉取的任何更新将在重新构建后自动可用。

用法

该服务器提供了几个与 Harvest 交互的工具：

log_time

使用自然语言记录时间条目。示例：

常规时间条目：

"今天在项目 X 上花了 2 小时进行开发工作"
"昨天在项目 Y 上花了 45 分钟进行测试"
"上周五在项目 Z 上花了 3.5 小时开会"

请假请求（自动使用标准工作日时长）：

"我今天病了"
"我今天不舒服"
"下周休年假"

get_time_report

使用自然语言查询获取时间报告。示例：

1. 时间段选项：

"显示上个月的时间报告"
"获取本周的时间摘要"
"显示 1 月 1 日到 1 月 31 日的小时数"
"报告第一季度的时间"
"告诉我昨天的小时数"

2. 报告类型：

• 按项目（默认）：

  "显示上个月的时间报告"
  "获取本周的项目小时数"
  

• 按客户：

  "显示本月按客户划分的时间报告"
  "获取第一季度按客户划分的小时数"
  

• 按任务：

  "显示 1 月份按任务划分的时间摘要"
  "获取上周的任务分解"
  

• 按团队成员：

  "显示上周的团队工时"
  "获取本月按用户划分的时间报告"
  

3. 报告详情： 每个报告包括：

• 总工作时长
• 可计费与不可计费时长
• 可计费金额（如果你有权限）
• 基于报告类型的项目/客户/任务/用户详细信息

list_projects

列出所有可用的 Harvest 项目：

列出我的项目

list_tasks

列出特定项目的可用任务：

显示项目 X 的任务

list_entries

查看最近的时间条目：

显示我最近的时间条目

配置

服务器支持以下环境变量：

• HARVEST_ACCESS_TOKEN：你的 Harvest 个人访问令牌
• HARVEST_ACCOUNT_ID：你的 Harvest 帐户 ID
• STANDARD_WORK_DAY_HOURS：一个完整工作日的默认时长（默认：7.5）
• TIMEZONE：你的时区（默认：Australia/Perth）

开发

服务器使用以下技术构建：

• TypeScript
• MCP SDK
• chrono-node 用于自然语言日期解析
• Harvest API v2

要贡献代码：

1. Fork 存储库
2. 创建一个功能分支
3. 提交一个 pull request

许可证

MIT 许可证 - 有关详细信息，请参阅 LICENSE