Graphql

GraphQL MCP ツール

GraphQL API とのやり取り機能を提供する、Model Context Protocol（MCP）サーバーの実装です。このサーバーにより、AI アシスタントは標準化された一連のツールを通じて GraphQL API とやり取りできます。

コンポーネント

ツール

• graphql_query

  • 任意のエンドポイントに対して GraphQL クエリを実行します
  • 入力：
    • query（string）：実行する GraphQL クエリ
    • variables（object、任意）：クエリ用の変数
    • endpoint（string、任意）：GraphQL エンドポイント URL
    • headers（object、任意）：リクエスト用の HTTP ヘッダー
    • timeout（number、任意）：リクエストのタイムアウト（ミリ秒）
    • allowMutations（boolean、任意）：ミューテーション操作を許可するかどうか

• graphql_introspect

  • GraphQL スキーマ情報を取得して調査します
  • 入力：
    • endpoint（string、任意）：GraphQL エンドポイント URL
    • headers（object、任意）：リクエスト用の HTTP ヘッダー
    • includeDeprecated（boolean、任意）：非推奨の型／フィールドを含めるかどうか

Claude Desktop での使用方法

NPX

{
  "mcpServers": {
    "graphql": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-graphql-tools",
        "--endpoint=https://api.github.com/graphql",
        "--headers={\"Authorization\":\"Bearer YOUR_GITHUB_TOKEN\"}",
        "--timeout=30000",
        "--maxComplexity=100"
      ]
    }
  }
}

設定オプション

このサーバーは、次のコマンドライン引数を受け付けます。

• --endpoint (-e)：デフォルトの GraphQL エンドポイント URL（デフォルト：http://localhost:4000/graphql）
• --headers (-H)：すべてのリクエストに使用するデフォルトのヘッダーを JSON 文字列で指定します
• --timeout (-t)：デフォルトのリクエストタイムアウト（ミリ秒、デフォルト：30000）
• --maxComplexity (-m)：許容されるクエリの最大複雑度（デフォルト：100）

ライセンス

この MCP サーバーは MIT ライセンスの下でライセンスされています。これは、MIT ライセンスの利用規約に従うことを条件に、ソフトウェアを自由に使用、変更、配布できることを意味します。詳しくは、プロジェクトリポジトリ内の LICENSE ファイルをご覧ください。