Gibwork MCP

🚀 GibWork MCP 服務器

GibWork MCP 服務器是一個用於與 GibWork 平臺交互的模型上下文協議（MCP）服務器實現。它提供了一系列工具，可通過 MCP 在 GibWork 平臺上高效管理任務，為用戶提供便捷的任務管理體驗。

🚀 快速開始

GibWork MCP 服務器允許您通過 MCP 協議與 GibWork 平臺進行交互，以管理任務。以下是使用該服務器的快速步驟：

1. 克隆倉庫：

git clone <repository-url>
cd gibwork-mcp

2. 安裝依賴項：

pnpm install

3. 在項目根目錄中創建一個 .env 文件，並添加您的 Solana 私鑰：

SOLANA_PRIVATE_KEY=your_private_key_here

4. 配置 Claude Desktop：
   • 打開 Claude Desktop 設置
   • 導航到開發人員設置
   • 編輯配置文件位置：
     • Windows：%APPDATA%\Claude\claude_desktop_config.json
     • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • 添加以下配置：

   {
     "mcpServers": {
       "gibwork": {
         "command": "C:\\Program Files\\nodejs\\node",
         "args": ["C:\\path\\to\\gibwork-mcp\\dist\\index.js"]
       }
     }
   }
   

   注意：根據您的系統配置調整路徑。

有關 MCP 配置的更多詳細信息，請訪問模型上下文協議快速入門指南。

✨ 主要特性

• 任務管理：支持在 GibWork 平臺上創建、檢索和搜索任務，滿足多樣化的任務管理需求。
• MCP 協議：實現了模型上下文協議，用於標準化工具交互，確保與平臺的穩定通信。

📦 安裝指南

先決條件

• Node.js（推薦使用最新 LTS 版本）
• pnpm 包管理器（10.5.2 或更高版本）
• Solana 私鑰（用於任務創建）

安裝步驟

1. 克隆倉庫：

git clone <repository-url>
cd gibwork-mcp

2. 安裝依賴項：

pnpm install

3. 配置環境變量：在項目根目錄中創建一個 .env 文件，並添加您的 Solana 私鑰：

SOLANA_PRIVATE_KEY=your_private_key_here

4. 配置 Claude Desktop：
   • 打開 Claude Desktop 設置
   • 導航到開發人員設置
   • 編輯配置文件位置：
     • Windows：%APPDATA%\Claude\claude_desktop_config.json
     • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • 添加以下配置：

   {
     "mcpServers": {
       "gibwork": {
         "command": "C:\\Program Files\\nodejs\\node",
         "args": ["C:\\path\\to\\gibwork-mcp\\dist\\index.js"]
       }
     }
   }
   

   注意：根據您的系統配置調整路徑。

📚 詳細文檔

項目結構

gibwork-mcp/
├── src/
│   ├── index.ts      # 主服務器實現
│   └── utils.ts      # API交互的輔助函數
├── dist/             # 編譯後的 JavaScript 輸出
├── package.json      # 項目依賴和腳本
└── tsconfig.json     # TypeScript 配置

可用工具

該服務器實現了以下 MCP 工具：

1. get-tasks-by-id

   • 根據 ID 獲取特定任務
   • 參數：id（字符串）

2. get-tasks

   • 帶分頁和篩選功能獲取任務
   • 參數：
     • page（數字，默認值：1）
     • limit（數字，默認值：15）
     • pageAll（布爾值，默認值：false）
     • search（字符串，默認值：''）
     • orderBy（字符串，默認值：''）
     • tags（字符串數組，默認值：[]）

3. create-task

   • 在 GibWork 平臺上創建新任務
   • 參數：
     • title（字符串）
     • content（字符串）
     • requirements（字符串）
     • tags（字符串數組）
     • payer（字符串）
     • token（對象）

開發

1. 構建項目：

pnpm build

2. 運行開發服務器：

pnpm dev

配置

該服務器配置為以下設置運行：

• API 基本 URL：https://api2.gib.work
• 模塊系統：ES 模塊
• 目標：ES2022
• 嚴格類型檢查：啟用

🔧 技術細節

安全性

• 包含敏感信息的 .env 文件從版本控制中排除，確保敏感信息的安全。
• Solana 私鑰應保持安全，絕不在代碼庫中提交，防止私鑰洩露帶來的安全風險。