@gungi/mcp

Gungi MCP Server — Claude Code から Gungi プラットフォームを操作するための MCP サーバー。

v0.1.0 からのアップグレード

v0.1.5 で bin 名が gungi-mcp から mcp に変更されました。 Claude Code で登録済みの設定を以下の手順で更新してください:

# 旧設定を削除
claude mcp remove gungi

# 新設定を追加
claude mcp add gungi -- npx @gungi/mcp

セットアップ

claude mcp add gungi -- npx @gungi/mcp

認証

初回利用時に Claude Code から login ツールを実行すると、GitHub Device Flow でブラウザ認証が開始されます。

1. Claude Code が表示するコードとURLを確認
2. ブラウザで GitHub にログインし、コードを入力
3. Claude Code で login-confirm を実行して認証完了

認証情報は ~/.gungi/credentials.json に保存されます（ファイル権限: 0600）。

利用可能なツール

認証

| ツール | 説明 | |--------|------| | login | GitHub Device Flow で認証を開始 | | login-confirm | 認証フローを完了 |

エージェント管理

| ツール | 説明 | |--------|------| | list-agents | エージェント一覧を取得 | | get-agent | エージェント詳細を取得 | | create-agent | エージェントを作成 | | update-agent | エージェントを更新 | | import-agent-from-md | Markdown からエージェントをインポート | | export-agent-to-md | エージェントを Markdown にエクスポート |

チェーン管理

| ツール | 説明 | |--------|------| | list-chains | チェーン一覧を取得 | | get-chain | チェーン詳細を取得 | | update-chain | チェーンを更新 | | import-chain-from-yaml | YAML からチェーンをインポート | | export-chain-to-yaml | チェーンを YAML にエクスポート |

フェーズ管理

| ツール | 説明 | |--------|------| | list-phases | フェーズ一覧を取得 | | get-phase | フェーズ詳細を取得 | | update-phase | フェーズを更新 | | add-phase-to-chain | チェーンにフェーズを追加 |

タスク管理

| ツール | 説明 | |--------|------| | list-tasks | タスク一覧を取得 | | get-task | タスク詳細を取得 |

環境変数（オプション）

開発時やCI環境で使用できます。

| 変数 | 説明 | デフォルト | |------|------|-----------| | GUNGI_API_URL | API サーバーの URL | https://api.gungi-ai.com | | GUNGI_API_TOKEN | Bearer トークン（GUNGI_API_URL と併用） | — | | GUNGI_GITHUB_CLIENT_ID | GitHub OAuth App の Client ID | 本番値 |

# ローカル開発時の例
GUNGI_API_URL=http://localhost:3001 npx @gungi/mcp

要件

• Node.js >= 18.0.0
• Claude Code（MCP クライアント）

ライセンス

MIT