MCP Graphql

🚀 mcp - graphql

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

🚀 クイックスタート

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

環境変数（バージョン1.0.0の重大な変更）

⚠️ 重要提示

バージョン1.0.0から、コマンドライン引数は環境変数に置き換えられました。

💻 使用例

基本的な使用法

# 基本的な使用方法：ローカルの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 ALLOW_MUTATIONS=true npx mcp-graphql

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

📚 ドキュメント

リソース

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

利用可能なツール

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

1. introspect - schema：このツールはGraphQLスキーマを取得します。スキーマリソースがない場合は、まずこのツールを使用してください。これはローカルのスキーマファイルまたはイントロスペクションクエリを使用します。
2. query - graphql：エンドポイントに対してGraphQLクエリを実行します。デフォルトでは、ALLOW_MUTATIONSがtrueに設定されていない限り、ミューテーション操作は無効になっています。

📦 インストール

Smitheryを通じたインストール

Smitheryを通じて、Claude Desktop用のGraphQL MCPサーバーを自動的にインストールするには：

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

手動インストール

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

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

🔧 技術詳細

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

デフォルトでは、ミューテーション操作はセキュリティ対策として無効になっています。本番環境でミューテーション操作を有効にする場合は、慎重に検討してください。

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

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