Skip to main content
Glama
adrian-dotco

Harvest Natural Language Time Entry MCP Server

by adrian-dotco

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

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

特征

  • 🗣️ 自然语言时间条目解析

  • 🏖️ 特殊休假请求处理(例如,“我今天生病了”)

  • ⏰ 可配置的工作时间

  • 🌍 时区支持

  • 🎯 自动项目和任务匹配

  • 📅 智能日期解析(今天、昨天等)

Related MCP server: Harvest MCP Server

先决条件

  • Node.js 已安装

  • 收获账户

  • Harvest Developer Tools的个人访问令牌

  • 账户 ID(与您的令牌显示在同一页面上)

安装

安装

  1. 安装Claude 桌面应用程序

  2. 克隆此存储库:

git clone https://github.com/adrian-dotco/harvest-mcp-server.git cd harvest-mcp-server
  1. 安装依赖项并构建:

npm install npm run build
  1. 运行安装脚本:

node build/setup.js
  1. 按照提示输入您的:

  2. 重启 Claude 桌面应用程序

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

保持更新

要更新到最新版本:

git pull npm install npm run build

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

用法

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

对数时间

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

常规时间条目:

"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"

获取时间报告

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

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

  • 按项目(默认):

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

  • 总工作小时数

  • 计费小时数与非计费小时数

  • 可计费金额(如果您有权限)

  • 基于报告类型的项目/客户/任务/用户详细信息

列出项目

列出所有可用的 Harvest 项目:

List my projects

列出任务

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

Show tasks for Project X

列表条目

查看最近的时间条目:

Show my recent time entries

配置

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

  • 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 许可证 - 详情请参阅许可证

One-click Deploy
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/adrian-dotco/harvest-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server