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

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

<a href="https://glama.ai/mcp/servers/u2bir05hxy"> <img width="380" height="200" src="https://gips3.baidu.com/it/u=1769465469,260278385&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Harvest 自然语言时间记录 MCP 服务器" /> </a>

功能

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

预备条件

• 已安装 Node.js
• 一个 Harvest 账户
• 从 Harvest 开发者工具 获取的个人访问令牌
• 账户 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. 报告类型：

• 按项目（默认）：

  “显示上个月的时间报告”
  “获取本周的项目工时”
  

• 按客户：

  “显示本月按客户的时间报告”
  “获取第一季度按客户的工时”
  

• 按任务：

  “显示一月份按任务的时间摘要”
  “获取上周的任务分解”
  

• 按团队成员：

  “显示上周的团队工时”
  “获取本月按用户的时间报告”
  

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. 分叉仓库
2. 创建功能分支
3. 提交合并请求

许可证

MIT 许可证 - 详情见 LICENSE