JinDaGe - harvest-mcp-server MCP Details

article

README

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

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

🚀 快速开始

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

✨ 主要特性

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

📦 安装指南

安装

安装 Claude 桌面应用程序。
克隆此仓库：

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

安装依赖项并构建：

npm install
npm run build

运行设置脚本：

node build/setup.js

按照提示输入以下信息：
- Harvest 个人访问令牌（从 https://id.getharvest.com/developers 获取）
- Harvest 账户 ID
- 标准工作日时长（默认：7.5 小时）
- 时区（默认：澳大利亚珀斯）
重启 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 月 31 日的小时数"
"显示 Q1 的时间"
"显示昨天的小时数"

报告类型：

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

get_help

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

get_help

📚 详细文档

可以通过设置以下环境变量来配置服务器： | 属性 | 详情 | |------|------| | PORT | 服务运行的端口（默认：3000） | | DB_URL | 数据库连接 URL | | TOKEN_SECRET | 访问令牌密钥 |

🔧 技术细节

技术栈

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

贡献指南

克隆仓库并安装依赖：

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

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

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

提交拉取请求到主分支。

📄 许可证

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

harvest-mcp-server