收获自然语言时间条目 MCP 服务器

一个可以让您使用自然语言记录 Harvest 时间条目的 MCP 服务器，包括对请假请求的特殊处理。此服务器通过理解自然语言输入并自动处理诸如请假请求等常见场景，使时间跟踪更加直观。

功能

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

前提条件

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

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

常规时间条目：

"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. 报告类型：

• 按项目（默认）：

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

• 按客户：

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

• 按任务：

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

• 按团队成员：

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

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. 提交一个 Pull Request

许可证

MIT 许可证 - 详情请参阅 LICENSE