Harvest Natural Language Time Entry MCP Server

Harvest 自然语言工时录入 MCP 服务

一个让你通过自然语言记录 Harvest 工时的 MCP 服务，支持对请假申请进行特殊处理。该服务能够理解自然语言输入，并自动处理请假申请等常见场景，让工时跟踪更加直观。

功能

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

前提条件

• 已安装 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

使用自然语言记录工时。示例：

常规工时记录：

"2 hours on Project X doing development work today"
"45 minutes on Project Y testing yesterday"
"3.5 hours on Project Z meetings last Friday"

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

"I'm off sick today"
"I'm unwell today"
"Taking annual leave next week"

get_time_report

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

1. 时间段选项：

"Show time report for last month"
"Get time summary for this week"
"Show hours from January 1st to January 31st"
"Report time for Q1"
"Show me yesterday's hours"

2. 报告类型：

• 按项目（默认）：

  "Show time report for last month"
  "Get project hours for this week"
  

• 按客户：

  "Show time report by client for this month"
  "Get hours by client for Q1"
  

• 按任务：

  "Show time summary by task for January"
  "Get task breakdown for last week"
  

• 按团队成员：

  "Show team hours for last week"
  "Get time report by user for this month"
  

3. 报告详情： 每份报告包含：

• 总工作时长
• 可计费与不可计费时长
• 可计费金额（如果你有相应权限）
• 根据报告类型提供的项目／客户／任务／用户详情

list_projects

列出所有可用的 Harvest 项目：

List my projects

list_tasks

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

Show tasks for Project X

list_entries

查看近期工时记录：

Show my recent time 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. 提交拉取请求

许可证

MIT 许可证——详情请参阅 LICENSE