🚀 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 私钥应保持安全，绝不在代码库中提交，防止私钥泄露带来的安全风险。