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 : query 、オプションのvariables 、およびオプションのoperationNameを入力として、ターゲット API に対して任意の GraphQL クエリまたはミューテーションを実行します。

構成

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

• GRAPHQL_ENDPOINT : ターゲット GraphQL API の URL。

• AUTH_TOKEN : GraphQL API で認証するためのオプションのAuthorization: Bearer <token>ヘッダーのベアラー トークン。

クライアント構成

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

カーソル

1. カーソルMCP設定に移動します（カーソル > 設定 > カーソル設定 > MCP）

2. • 新しいグローバルMCPサーバーを追加に移動します

3. カーソル MCP 構成に以下を追加します。

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

クロードデスクトップ

1. Claude デスクトップの設定を開きます (Claude > 設定)。

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ツールを必要に応じて一覧表示し、呼び出すことができるようになります。サーバーがAPIに接続できるように、必要な環境変数（ GRAPHQL_ENDPOINTおよびオプションでAUTH_TOKEN ）を設定してください。