graphql-mcp-bridge は何をしますか？
🌉 GraphQL APIをModel Context Protocolでシームレスに接続し、データ管理と統合を強化します。
概要
zcebupelka/graphql-mcp-bridge は、GraphQL API と Model Context Protocol (MCP) 間のブリッジとして機能するツールです。これにより、AIエージェント（Claude Code など）が、MCPを介してGraphQLエンドポイントと直接対話できるようになります。
機能
- GraphQLスキーマのイントロスペクション: AIエージェントが利用可能なクエリ、ミューテーション、タイプを自動的に検出します。
- クエリの実行: エージェントが任意のGraphQLクエリを送信し、データを取得できます。
- ミューテーションの実行: エージェントがデータの変更操作を実行できます。
- 動的スキーマ解決: 接続されたGraphQLエンドポイントのスキーマに基づいて、利用可能なツールを自動的に生成します。
セットアップ
- リポジトリをクローンします：
git clone https://github.com/zcebupelka/graphql-mcp-bridge.git
cd graphql-mcp-bridge
- 依存関係をインストールします：
npm install
- 環境変数を設定します：
export GRAPHQL_ENDPOINT="https://your-graphql-api.com/graphql"
必要に応じて、認証情報を環境変数で設定することもできます：
export GRAPHQL_API_KEY="your-api-key"
- ブリッジを起動します：
npm start
MCPクライアントとの統合
このスキームをClaude Codeで使用するには、プロジェクトの.cursorまたはclaude_desktop_config.jsonに以下の設定を追加します：
{
"mcpServers": {
"graphql-bridge": {
"command": "node",
"args": ["path/to/graphql-mcp-bridge/index.js"],
"env": {
"GRAPHQL_ENDPOINT": "https://your-graphql-api.com/graphql"
}
}
}
}
使用例
ブリッジが起動すると、AIエージェントは以下のようなアクションを実行できます：
- 利用可能なクエリを一覧表示する
- 特定のデータを取得する（例：ユーザー情報、製品リスト）
- 新しいレコードを作成する（ミューテーション）
- 既存のデータを更新する
技術詳細
- 対応プラットフォーム: Claude Code, Cursor, その他MCP対応クライアント
- 実行環境: Node.js
- プロトコル: Model Context Protocol (MCP)
- ライセンス: MIT
貢献
プルリクエストは歓迎します。大きな変更を加える場合は、まずissueを開いて変更内容を議論してください。