GibWork MCP Server

GibWork MCP Server

用于与 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 设置
   • 前往 Developer 设置
   • 编辑以下位置的配置文件：
     • 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      # Main server implementation
│   └── utils.ts      # Utility functions for API interactions
├── dist/             # Compiled JavaScript output
├── package.json      # Project dependencies and scripts
└── tsconfig.json     # TypeScript configuration

可用工具

此服务实现了以下 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 Modules
• 目标：ES2022
• 严格类型检查：已启用

安全

• 包含敏感信息的 .env 文件已从版本控制中排除
• Solana 私钥应妥善保管，切勿提交到代码仓库

许可证

ISC 许可证