Gibwork MCP

🚀 GibWork MCP 服务器

GibWork MCP 服务器是一个用于与 GibWork 平台交互的模型上下文协议（MCP）服务器实现。它提供了一系列工具，可通过 MCP 在 GibWork 平台上高效管理任务。

🚀 快速开始

GibWork MCP 服务器能帮助你在 GibWork 平台上管理任务。以下是使用前的准备步骤：

1. 确保你已安装 Node.js（推荐使用最新 LTS 版本）和 pnpm 包管理器（10.5.2 或更高版本），并准备好 Solana 私钥（用于任务创建）。
2. 按照安装指南完成服务器的安装与配置。

✨ 主要特性

• 任务管理：可在 GibWork 平台上创建、检索和搜索任务，方便用户对任务进行全面管理。
• MCP 协议：实现了模型上下文协议，为工具交互提供标准化的方式，提升交互的规范性和效率。

📦 安装指南

克隆仓库

git clone <repository-url>
cd gibwork-mcp

安装依赖项

pnpm install

配置私钥

在项目根目录中创建一个 .env 文件，并添加您的 Solana 私钥：

SOLANA_PRIVATE_KEY=your_private_key_here

配置 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 工具：

get-tasks-by-id

• 功能：根据 ID 获取特定任务。
• 参数：id（字符串）

get-tasks

• 功能：带分页和筛选功能获取任务。
• 参数：
  • page（数字，默认值：1）
  • limit（数字，默认值：15）
  • pageAll（布尔值，默认值：false）
  • search（字符串，默认值：''）
  • orderBy（字符串，默认值：''）
  • tags（字符串数组，默认值：[]）

create-task

• 功能：在 GibWork 平台上创建新任务。
• 参数：
  • title（字符串）
  • content（字符串）
  • requirements（字符串）
  • tags（字符串数组）
  • payer（字符串）
  • token（对象）

开发

构建项目

pnpm build

运行开发服务器

pnpm dev

配置

该服务器配置为以下设置运行：

安全性

• 包含敏感信息的 .env 文件从版本控制中排除，确保敏感信息不会被意外提交。
• Solana 私钥应妥善保管，绝不在代码库中提交，防止私钥泄露带来的安全风险。