mcpField
H
Harvest MCP Server

Harvest MCP Server

本地服务
github.com/tgmclaughlin生产力578 周前更新
代码仓库

关于 Harvest MCP Server

Harvest MCP Server 让 Harvest 用户通过 MCP 管理工时记录，并查看项目和任务。工具涵盖运行中的计时器与手动录入。

主要功能

  1. 01获取已验证用户信息
  2. 02列出、新建、更新和删除工时记录
  3. 03启动和停止工时记录
  4. 04浏览项目和任务

适用场景

  1. 01将工作记录到 Harvest 项目
  2. 02更正或删除已有工时记录
  3. 03启动或停止计时器

MCP 相关

它向 MCP 客户端提供 Harvest 用户、工时记录、项目和任务操作工具。使用时需要 Harvest API 凭据。

#mcp#harvest#mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "harvest": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "pull"
      ]
    }
  }
}
启动命令docker run -i --rm pull

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
ocipull

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Harvest MCP Server

用于与 Harvest 时间追踪 API 交互。

图片

https://www.loom.com/share/b611c5d90a454fb2a7eab99ec0dc3d20?sid=edad9a28-1bbb-452c-838d-721bc435908f

功能

此 MCP 服务提供以下工具，用于与 Harvest 交互：

用户信息
  • get_current_user：获取已通过身份验证的用户信息
时间记录
  • list_time_entries：列出时间记录，可选按日期筛选
  • get_time_entry：按 ID 获取特定时间记录
  • create_time_entry：通过时长创建新的时间记录
  • create_time_entry_via_start_end：使用开始和结束时间创建时间记录
  • update_time_entry：更新现有时间记录
  • delete_time_entry：删除时间记录
  • delete_time_entry_external_reference：删除时间记录的外部引用
  • restart_time_entry：重新启动已停止的时间记录
  • stop_time_entry：停止正在运行的时间记录
项目和任务
  • list_projects：列出所有项目，可选筛选
  • list_tasks：列出所有任务，可选筛选

设置说明

前提条件
  • Docker
  • 拥有 API 凭据的 Harvest 账户
安装
Claude Desktop 用户

如果你使用 Claude Desktop，只需将以下配置添加到 MCP 配置文件中：

"harvest": {
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "HARVEST_ACCOUNT_ID",
    "-e",
    "HARVEST_TOKEN",
    "tommcl/harvest-mcp"
  ],
  "env": {
    "HARVEST_ACCOUNT_ID": "YOUR_ACCOUNT_ID",
    "HARVEST_TOKEN": "YOUR_API_TOKEN"
  }
}

注意：需要安装并运行 Docker Desktop。

凭据：你可以从 Harvest Developer Tools 页面获取个人访问令牌（PAT）和账户 ID。

选项 1：从 Docker Hub 拉取（适用于其他 MCP 客户端）
  1. 直接从 Docker Hub 拉取 Docker 镜像： 
    docker pull tommcl/harvest-mcp
选项 2：本地构建（用于开发）

  1. 克隆仓库：

    git clone https://github.com/yourusername/harvest-mcp.git
cd harvest-mcp

  2. 构建 Docker 镜像：

    docker build -t mcp/harvest .

    然后在 MCP 配置中使用 "mcp/harvest" 替代 "tommcl/harvest-mcp"。

    注意：请将示例凭据替换为你自己的 Harvest API 凭据。你可以从 Harvest Developer Tools 页面获取个人访问令牌（PAT）和账户 ID。

使用方法

使用 Claude Desktop 进行测试。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。