Graphql MCP Toolkit

🚀 mcp-graphql

LLMがGraphQL APIとやり取りできるようにするモデルコンテキストプロトコルサーバーです。この実装では、スキーマのイントロスペクションとクエリの実行機能が提供され、モデルがGraphQL APIを動的に発見して使用できるようになります。

🚀 クイックスタート

mcp-graphql を実行する際に正しいエンドポイントを指定すると、自動的にクエリのイントロスペクションを試みます。

コマンドライン引数

例

# 基本的な使用方法、ローカルのGraphQLサーバーと一緒に使用する場合
npx mcp-graphql --endpoint http://localhost:3000/graphql

# カスタムヘッダーを使用する場合
npx mcp-graphql --endpoint https://api.example.com/graphql --headers '{"Authorization":"Bearer token123"}'

# ミューテーション操作を有効にする場合
npx mcp-graphql --endpoint http://localhost:3000/graphql --enable-mutations

# イントロスペクションではなくローカルのスキーマファイルを使用する場合
npx mcp-graphql --endpoint http://localhost:3000/graphql --schema ./schema.graphql

💻 使用例

基本的な使用法

# 基本的な使用方法、ローカルのGraphQLサーバーと一緒に使用する場合
npx mcp-graphql --endpoint http://localhost:3000/graphql

高度な使用法

# カスタムヘッダーを使用する場合
npx mcp-graphql --endpoint https://api.example.com/graphql --headers '{"Authorization":"Bearer token123"}'

✨ 主な機能

サーバーは2つの主要なツールを提供します：

1. introspect-schema: このツールはGraphQLスキーマを取得します。スキーマにアクセスできない場合は、まずこのツールを使用してください。これはローカルのスキーマファイルまたはイントロスペクションクエリに基づいて動作します。

2. query-graphql: エンドポイントに対してGraphQLクエリを実行します。デフォルトではミューテーション操作は無効になっており、--enable-mutations を指定しない限り実行できません。

📚 ドキュメント

リソース

• graphql-schema: サーバーはGraphQLスキーマをリソースとして公開し、クライアントがアクセスできるようにします。これはローカルのスキーマファイルまたはイントロスペクションクエリの結果です。

📦 インストール

Smithery経由でのインストール

Smithery を通じてGraphQL MCPツールキットを自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install mcp-graphql --client claude

手動インストール

Claudeに手動でインストールすることもできます。

{
  "mcpServers": {
    "mcp-graphql": {
      "command": "npx",
      "args": ["mcp-graphql", "--endpoint", "http://localhost:3000/graphql"]
    }
  }
}

🔧 技術詳細

セキュリティに関する注意事項

ミューテーションはデフォルトで無効になっており、これはLLMがデータベースやサービスのデータを変更するのを防ぐためのセキュリティ対策です。本番環境でミューテーション操作を有効にする場合は、慎重に検討してください。

独自サーバーのカスタマイズ

これは非常に汎用的な実装であり、完全なイントロスペクションを可能にし、ユーザーが任意の操作（ミューテーションを含む）を実行できるようにします。より特定の実装が必要な場合は、独自のMCPを作成し、クライアントが呼び出すツールを特定のクエリフィールドや変数のみに制限することをおすすめします。この実装を参考にすることができます。