MCP Server Harvest

🚀 豐收時間追蹤 MCP 服務器

這是一個基於 TypeScript 的 MCP（模型上下文協議）服務器，專為豐收時間追蹤應用程序打造，可讓 LLM 客戶端與豐收賬戶進行交互。

🚀 快速開始

先決條件

• Bun 運行時
• 帶有 API 訪問權限的豐收賬戶
• 從豐收獲取的個人訪問令牌
• 賬戶 ID（來自豐收）

更多細節請參考豐收 API 文檔中的個人訪問令牌創建說明。

✨ 主要特性

此服務器提供了一系列工具，可用於獲取公司、客戶、項目、用戶等信息，還能進行時間記錄的搜索、創建等操作。

📦 安裝指南

在 Claude Desktop 中配置

在 settings.json 文件中添加以下內容：

{
  "mcpServers": {
    "Harvest": {
      "command": "npx",
      "args": [
        "@harvesttime/tracing-mcp-server",
        "--accountId",
        "<豐收賬戶 ID>",
        "--token",
        "<豐收個人訪問令牌>"
      ],
      "env": {}
    }
  }
}

在 Visual Studio Code 中配置

在 launch.json 文件中添加以下內容：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "啟動豐收時間追蹤 MCP 服務器",
      "type": "node",
      "request": "launch",
      "program": "$npmBin/file:@harvesttime/tracing-mcp-server",
      "args": [
        "--accountId",
        "<豐收賬戶 ID>",
        "--token",
        "<豐收個人訪問令牌>"
      ]
    }
  ]
}

在 VS Code 中啟動

1. 打開終端。
2. 運行以下命令：

   npm install --global @harvesttime/tracing-mcp-server
   

3. 啟動配置文件中的 "啟動豐收時間追蹤 MCP 服務器" 配置。

在命令行中使用

直接運行以下命令：

@harvesttime/tracing-mcp-server --accountId <豐收賬戶 ID> --token <豐收個人訪問令牌>

💻 使用示例

可用工具

📚 詳細文檔

開發

1. 克隆倉庫。
2. 安裝依賴：

   npm install
   

3. 啟動開發服務器：

   npm run dev
   

4. 測試：

   npm test
   

提交代碼

1. 創建功能分支：

   git checkout -b feature/<功能名稱>
   

2. 提交更改：

   git add .
   git commit -m "提交信息"
   

3. 推送到遠程倉庫並創建拉取請求：

   git push origin feature/<功能名稱>
   

維護

更新依賴

1. 更新 package.json 中的依賴版本。
2. 保存更改。
3. 安裝更新的依賴：

   npm install
   

打包

1. 運行打包命令：

   npm run build
   

貢獻指南

歡迎貢獻！請遵循以下步驟：

1. 分叉倉庫。
2. 提交您的更改。
3. 創建拉取請求。

確保代碼符合 代碼規範 並通過所有測試。