Harvest 自然语言时间输入 MCP 服务器
MCP 服务器允许您使用自然语言记录收获时间条目,包括对休假申请的特殊处理。该服务器通过理解自然语言输入并自动处理休假申请等常见场景,使时间跟踪更加直观。
特征
🗣️ 自然语言时间条目解析
🏖️ 特殊休假请求处理(例如,“我今天生病了”)
⏰ 可配置的工作时间
🌍 时区支持
🎯 自动项目和任务匹配
📅 智能日期解析(今天、昨天等)
Related MCP server: Harvest MCP Server
先决条件
Node.js 已安装
收获账户
Harvest Developer Tools的个人访问令牌
账户 ID(与您的令牌显示在同一页面上)
安装
安装
克隆此存储库:
安装依赖项并构建:
运行安装脚本:
按照提示输入您的:
Harvest 个人访问令牌(来自https://id.getharvest.com/developers )
收获账户ID
标准工作日小时数(默认值:7.5)
时区(默认:澳大利亚/珀斯)
重启 Claude 桌面应用程序
就这样!现在您可以在 Claude 中使用自然语言时间跟踪了。
保持更新
要更新到最新版本:
安装脚本将配置 Claude 以使用您本地构建的服务器,因此您提取的任何更新都将在重建后自动可用。
用法
该服务器提供了几种与 Harvest 交互的工具:
对数时间
使用自然语言记录时间条目。示例:
常规时间条目:
休假申请(自动使用标准工作日时间):
获取时间报告
使用自然语言查询获取时间报告。示例:
时间段选项:
报告类型:
按项目(默认):
"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"
报告详情:每份报告包括:
总工作小时数
计费小时数与非计费小时数
可计费金额(如果您有权限)
基于报告类型的项目/客户/任务/用户详细信息
列出项目
列出所有可用的 Harvest 项目:
列出任务
列出特定项目的可用任务:
列表条目
查看最近的时间条目:
配置
服务器支持以下环境变量:
HARVEST_ACCESS_TOKEN:您的 Harvest 个人访问令牌HARVEST_ACCOUNT_ID:您的 Harvest 帐户 IDSTANDARD_WORK_DAY_HOURS:完整工作日的默认小时数(默认值:7.5)TIMEZONE:您的时区(默认:澳大利亚/珀斯)
发展
该服务器使用以下方式构建:
TypeScript
MCP SDK
用于自然语言日期解析的 chrono-node
收获 API v2
贡献:
分叉存储库
创建功能分支
提交拉取请求
执照
MIT 许可证 - 详情请参阅许可证