Harvest 时间追踪 MCP 服务器

一个基于 TypeScript 的 MCP (模型上下文协议) 服务器，用于 Harvest 时间追踪应用，使 LLM 客户端能够与 Harvest 账户交互。

前提条件

• Bun 运行时
• 具有 API 访问权限的 Harvest 账户
• 来自 Harvest 的 API 个人访问令牌
• 来自 Harvest 的账户 ID

有关如何创建个人访问令牌的更多详细信息，请参阅 Harvest API 文档。

工具

1. get-company - 获取公司信息
   • 输入：无
   • 输出：返回公司信息（名称、URL、ID 和货币）。
2. search-clients - 在 Harvest 账户中搜索客户
   • 输入：
     • name: string (可选) - 要搜索的客户的名称。
     • isActive: boolean (可选) - 按其活动状态过滤客户。
   • 输出：返回包含 ID 和其他详细信息的客户列表。
3. get-client - 获取客户信息
   • 输入：
     • clientId: string - 要检索的客户的 ID。
   • 输出：返回有关指定客户的详细信息。
4. search-projects - 在 Harvest 账户中搜索项目
   • 输入：
     • name: string (可选) - 要搜索的项目的名称。
     • clientId: string (可选) - 用于过滤项目的客户的 ID。
     • isActive: boolean (可选) - 按其活动状态过滤项目。
   • 输出：返回包含 ID 和其他详细信息的项目列表。
5. get-project - 获取项目信息
   • 输入：
     • projectId: string - 要检索的项目的 ID。
   • 输出：返回有关指定项目的详细信息。
6. list-users - 列出 Harvest 账户中的所有用户
   • 输入：无
   • 输出：返回包含 ID 和其他详细信息的用户列表。
7. get-user - 获取用户信息
   • 输入：
     • userId: string - 要检索的用户的 ID。
   • 输出：返回有关指定用户的详细信息。
8. list-project-users - 列出所有项目用户分配
   • 输入：
     • projectId: string - 要检索用户的项目的 ID。
   • 输出：返回分配给指定用户的项目列表。
9. list-project-tasks - 列出所有项目任务分配
   • 输入：
     • projectId: string - 要检索任务的项目的 ID。
   • 输出：返回分配给指定项目的任务列表。

注意：更多工具即将推出。

用法

Claude Desktop

• 打开 Claude desktop 配置文件 claude-desktop-config.json 并在 mcpServers 下设置以下详细信息。

  {
    "mcpServers": {
      "Harvest": {
        "command": "npx",
        "args": [
          "@harvest/mcp-server-typescript",
          // 或者使用本地构建的路径
          // "path/to/local/build/dist/index.js"
        ],
        "env": {
          "HARVEST_ACCOUNT_ID": "<Harvest 账户 ID>",
          "HARVEST_ACCESS_TOKEN": "<Harvest 个人访问令牌>",
          "HARVEST_BASE_URL": "<Harvest 基本 URL>"
        }
      }
    }
  }
  

Cursor IDE

• 打开 Cursor IDE 配置文件 ~/.cursor/mcp.json 或 <project-root>/.cursor/mcp.json 并在 mcpServers 下设置以下详细信息。

  {
    "mcpServers": {
      "Harvest": {
        "command": "npx",
        "args": [
          "@harvest/mcp-server-typescript",
          // 或者使用本地构建的路径
          // "path/to/local/build/dist/index.js"
        ],
        "env": {
          "HARVEST_ACCOUNT_ID": "<Harvest 账户 ID>",
          "HARVEST_ACCESS_TOKEN": "<Harvest 个人访问令牌>",
          "HARVEST_BASE_URL": "<Harvest 基本 URL>"
        }
      }
    }
  }
  

本地安装和开发

1. 安装依赖项：

   npm install
   

2. 构建项目：

   npm run build
   

这将创建一个包含已编译 JavaScript 文件的 dist 目录。

3. 要使用本地开发版本的 MCP 服务器而不是已发布的版本，您可以直接从本地构建运行服务器：

   npm run build
   

   修改任何客户端（Claude、Cursor）中的 MCP 服务器配置文件

    {
      "mcpServers": {
        "Harvest": {
          "command": "node",
          "args": [
            "path/to/local/build/dist/index.js"
          ],
          "env": {
            "HARVEST_ACCOUNT_ID": "<Harvest 账户 ID>",
            "HARVEST_ACCESS_TOKEN": "<Harvest 个人访问令牌>",
            "HARVEST_BASE_URL": "<Harvest 基本 URL>"
          }
        }
      }
    } 
   

4. 重新启动客户端应用程序（Claude、Cursor）以应用更改并测试最新更改，而无需发布新版本。