mcp4gql - GraphQL MCP Server

mcp4gql - GraphQL MCP サーバー

このプロジェクトは、Model Context Protocol（MCP）を実装する Node.js/TypeScript サーバーです。ブリッジとして機能し、MCP クライアント（Cursor など）が対象の GraphQL API とやり取りできるようにします。

機能

• MCP サーバー： @modelcontextprotocol/sdk の MCP Server クラスを実装します。
• Stdio トランスポート： 標準入力／出力を介してクライアントと通信します。
• GraphQL クライアント： axios を使用して、設定された GraphQL エンドポイントにリクエストを送信します。
• 汎用 GraphQL ツール： MCP クライアントに次のツールを提供します。
  • introspectGraphQLSchema：イントロスペクションを使用して、対象の GraphQL API スキーマを取得します。
  • executeGraphQLOperation：対象 API に対して任意の GraphQL クエリまたはミューテーションを実行します。入力として query、任意の variables、任意の operationName を受け取ります。

設定

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

• GRAPHQL_ENDPOINT：対象の GraphQL API の URL です。
• AUTH_TOKEN：GraphQL API の認証に使用する、任意の Authorization: Bearer <token> ヘッダー用のベアラートークンです。

クライアントの設定

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

Cursor

1. Cursor の MCP 設定を開きます（Cursor > Settings > Cursor Settings > MCP）

2. • Add new global MCP server を選択します

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. Developer > Edit Config に移動します。

3. 次の内容を設定に追加します。

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

設定が完了すると、MCP クライアントは必要に応じて、このサーバーが提供する introspectGraphQLSchema および executeGraphQLOperation ツールを一覧表示して呼び出せるようになります。サーバーが API に接続できるよう、設定で必須の環境変数（GRAPHQL_ENDPOINT と、任意の AUTH_TOKEN）を指定してください。