GibWork MCP Server

GibWork MCP Server

GibWork プラットフォームと連携するための Model Context Protocol（MCP）サーバーの実装です。このサーバーは、MCP を通じて GibWork プラットフォーム上のタスクを管理するツールを提供します。

Features

• タスク管理：GibWork プラットフォーム上でタスクを作成、取得、検索できます
• MCP プロトコル：標準化されたツール連携のために Model Context Protocol を実装しています

Prerequisites

• Node.js（最新の LTS バージョンを推奨）
• pnpm パッケージマネージャー（バージョン 10.5.2 以上）
• Solana の秘密鍵（タスクの作成に必要）

Installation

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 settings に移動します
   • 次の場所にある設定ファイルを編集します：
     • 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 の設定について詳しくは、Model Context Protocol クイックスタートガイドをご覧ください。

Project Structure

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

Available Tools

サーバーは次の 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（オブジェクト）

Development

1. プロジェクトをビルドします：

pnpm build

2. 開発サーバーを実行します：

pnpm dev

Configuration

サーバーは次の設定で実行されます：

• API ベース URL：https://api2.gib.work
• モジュールシステム：ES Modules
• ターゲット：ES2022
• 厳密な型チェック：有効

Security

• 機密情報を含む .env ファイルはバージョン管理から除外されています
• Solana の秘密鍵は安全に保管し、リポジトリにコミットしないでください

License

ISC ライセンス