Harvest Natural Language Time Entry MCP Server

Harvest 自然语言时间输入 MCP 服务器

MCP 服务器允许您使用自然语言记录收获时间条目，包括对休假申请的特殊处理。该服务器通过理解自然语言输入并自动处理休假申请等常见场景，使时间跟踪更加直观。

特征

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

先决条件

• Node.js 已安装
• 收获账户
• Harvest Developer Tools的个人访问令牌
• 账户 ID（与您的令牌显示在同一页面上）

安装

安装

1. 安装Claude 桌面应用程序
2. 克隆此存储库：

3. 安装依赖项并构建：

4. 运行安装脚本：

5. 按照提示输入您的：
   • Harvest 个人访问令牌（来自https://id.getharvest.com/developers ）
   • 收获账户ID
   • 标准工作日小时数（默认值：7.5）
   • 时区（默认：澳大利亚/珀斯）
6. 重启 Claude 桌面应用程序

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

保持更新

要更新到最新版本：

安装脚本将配置 Claude 以使用您本地构建的服务器，因此您提取的任何更新都将在重建后自动可用。

用法

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

对数时间

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

常规时间条目：

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

获取时间报告

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

1. 时间段选项：

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. 报告详情：每份报告包括：

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

列出项目

列出所有可用的 Harvest 项目：

列出任务

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

列表条目

查看最近的时间条目：

配置

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

• HARVEST_ACCESS_TOKEN ：您的 Harvest 个人访问令牌
• HARVEST_ACCOUNT_ID ：您的 Harvest 帐户 ID
• STANDARD_WORK_DAY_HOURS ：完整工作日的默认小时数（默认值：7.5）
• TIMEZONE ：您的时区（默认：澳大利亚/珀斯）

发展

该服务器使用以下方式构建：

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

贡献：

1. 分叉存储库
2. 创建功能分支
3. 提交拉取请求

执照

MIT 许可证 - 详情请参阅许可证