🚀 基于自然语言的时间录入 Harvest MCP 服务器

这是一个 MCP 服务器，允许用户使用自然语言进行 Harvest 时间录入，还能对请假请求进行特殊处理。它通过理解自然语言输入，自动处理常见场景（如请假请求），让时间跟踪变得更加直观。

🚀 快速开始

本服务器可让你轻松使用自然语言进行 Harvest 时间录入。按照以下步骤操作，即可开启便捷的时间跟踪之旅。

✨ 主要特性

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

📦 安装指南

安装

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 小时）
   • 时区（默认：澳大利亚珀斯）
6. 重启 Claude 桌面应用程序。

完成以上步骤后，你就可以在 Claude 中使用自然语言进行时间跟踪啦。

更新

若要更新到最新版本，可执行以下命令：

git pull
npm install
npm run build

设置脚本已配置为使用本地构建的服务器，因此重建后任何更新都会自动生效。

💻 使用示例

基础用法

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

log_time

使用自然语言记录时间，示例如下： 常规时间录入：

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

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

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

get_time_report

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

1. 时间段选项：

"显示上个月的时间报告"
"获取本周的摘要"
"显示 1 月 1 日到 1 月 31 日的小时数"
"显示 Q1 的时间"
"显示昨天的小时数"

2. 报告类型：

• 按项目汇总
• 按任务分组
• 显示趋势分析

get_help

获取可用命令列表和简要说明：

get_help

📚 详细文档

可以通过设置以下环境变量来配置服务器：

🔧 技术细节

技术栈

• 后端：Node.js, Express
• 数据库：MongoDB
• 编程语言：JavaScript/TypeScript

贡献指南

1. 克隆仓库并安装依赖：

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

2. 创建功能分支并提交更改：

git checkout -b feature/new-feature
# 进行修改
git add .
git commit -m "添加新功能"
git push origin feature/new-feature

3. 提交拉取请求到主分支。

📄 许可证

该项目使用 MIT 许可证。有关详细信息，请参阅 LICENSE 文件。