Graphql

🚀 GraphQL MCP ツールサーバー

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

✨ 主な機能

ツール

• graphql_query

  • 任意のエンドポイントで GraphQL クエリを実行します。
  • 入力:
    • query (文字列): 実行する GraphQL クエリ
    • variables (オブジェクト, オプション): クエリ変数
    • endpoint (文字列, オプション): GraphQL エンドポイントの URL
    • headers (オブジェクト, オプション): リクエストの HTTP ヘッダー
    • timeout (数値, オプション): リクエストのタイムアウト時間（ミリ秒）
    • allowMutations (ブール値, オプション): ミューテーション操作を許可するかどうか

• graphql_introspect

  • GraphQL スキーマ情報を取得して探索します。
  • 入力:
    • endpoint (文字列, オプション): GraphQL エンドポイントの URL
    • headers (オブジェクト, オプション): リクエストの HTTP ヘッダー
    • includeDeprecated (ブール値, オプション): 非推奨の型/フィールドを含めるかどうか

💻 使用例

基本的な使用法

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 License に基づいて配布されています。これは、MIT License の条項と条件に従う限り、ソフトウェアを自由に使用、変更、配布することができることを意味します。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。