Graphql Bridge

🚀 mcp4gql - GraphQL MCP サーバー

このプロジェクトは、Node.js と TypeScript をベースにしたサーバーで、Model Context Protocol (MCP) を実装しています。MCP クライアント（Cursor など）とターゲットの GraphQL API の間の橋渡しを行います。

🚀 クイックスタート

このサーバーは、Node.js と TypeScript を利用して、Model Context Protocol (MCP) を実装しています。MCP クライアント（Cursor など）とターゲットの GraphQL API の間の橋渡しを行います。

✨ 主な機能

• MCP サーバー：@modelcontextprotocol/sdk の MCP Server クラスを実装しています。
• 標準入出力伝送：標準入力と出力を通じてクライアントと通信します。
• GraphQL クライアント：axios を使用して、ターゲットの GraphQL エンドポイントにリクエストを送信します。
• 汎用的な GraphQL ツール：MCP クライアントに以下のツールを提供します。
  • introspectGraphQLSchema：introspection を使用して、ターゲットの GraphQL API のスキーマを取得します。
  • executeGraphQLOperation：ターゲットの API に対する任意の GraphQL クエリまたはミューテーションを実行します。query、オプションの variables、オプションの operationName を入力として受け取ります。

📦 インストール

サーバーには以下の環境変数が必要です。

📚 ドキュメント

クライアント設定

Cursor や Claude Desktop などのクライアントがこのサーバーが提供するツールを使用できるようにするには、npx コマンドを実行するように設定する必要があります。

Cursor

1. Cursor MCP 設定（Cursor > Settings > Cursor Settings > MCP）に移動します。
2. 新しいグローバル MCP サーバーを追加するためにクリックします。
3. 以下の内容を Cursor MCP 設定に追加します。

{
  "mcpServers": {
    "mcp4gql": {
      "command": "npx",
      "type": "stdio",
      "args": ["-y", "mcp4gql"],
      "env": {
        "GRAPHQL_ENDPOINT": "YOUR_GRAPHQL_ENDPOINT_URL",
        "AUTH_TOKEN": "YOUR_OPTIONAL_AUTH_TOKEN"
      }
    }
  }
}

Claude Desktop

1. Claude Desktop 設定（Claude > Settings）を開きます。
2. 開発者 > 設定を編集に移動します。
3. 設定に以下の内容を追加します。

{
  "mcpServers": {
    "mcp4gql": {
      "command": "npx",
      "args": ["-y", "mcp4gql"],
      "env": {
        "GRAPHQL_ENDPOINT": "YOUR_GRAPHQL_ENDPOINT_URL",
        "AUTH_TOKEN": "YOUR_OPTIONAL_AUTH_TOKEN"
      }
    }
  }
}

設定が完了したら、MCP クライアントはこのサーバーが提供する introspectGraphQLSchema と executeGraphQLOperation ツールを一覧表示し、関連する場合には呼び出すことができます。設定で必要な環境変数（GRAPHQL_ENDPOINT とオプションの AUTH_TOKEN）を設定することを忘れないでください。そうすることで、サーバーがあなたの API に接続できるようになります。