GibWork MCP 服务器

一个用于与GibWork平台交互的模型上下文协议（MCP）服务器实现。该服务器提供工具以通过MCP在GibWork平台上管理任务。

功能

• 任务管理：创建、检索和搜索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"]
       }
     }
   }
   

   注意：根据您的系统配置调整路径。

有关MCP配置的更多详细信息，请访问模型上下文协议快速入门指南。

项目结构

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 私钥应保持安全，绝不在代码库中提交