Skip to main content
Glama

mcp-graphql

鍛冶屋のバッジ

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

使用法

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

環境変数(1.0.0 での重大な変更)

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

環境変数

説明

デフォルト

ENDPOINT

GraphQLエンドポイントURL

http://localhost:4000/graphql

HEADERS

リクエストのヘッダーを含むJSON文字列

{}

ALLOW_MUTATIONS

突然変異操作を有効にする(デフォルトでは無効)

false

NAME

MCPサーバーの名前

mcp-graphql

SCHEMA

ローカル GraphQL スキーマ ファイルへのパス (オプション)

-

# Basic usage with a local GraphQL server ENDPOINT=http://localhost:3000/graphql npx mcp-graphql # Using with custom headers ENDPOINT=https://api.example.com/graphql HEADERS='{"Authorization":"Bearer token123"}' npx mcp-graphql # Enable mutation operations ENDPOINT=http://localhost:3000/graphql ALLOW_MUTATIONS=true npx mcp-graphql # Using a local schema file instead of introspection ENDPOINT=http://localhost:3000/graphql SCHEMA=./schema.graphql npx mcp-graphql

Related MCP server: mcp-graphql-schema

リソース

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

利用可能なツール

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

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

  2. query-graphql : エンドポイントに対してGraphQLクエリを実行します。デフォルトでは、 ALLOW_MUTATIONStrueに設定されていない限り、ミューテーションは無効になっています。

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の GraphQL MCP Server を自動的にインストールするには:

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

手動でインストールする

Claude に手動でインストールできます:

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

セキュリティに関する考慮事項

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

独自のサーバーに合わせてカスタマイズ

これは非常に汎用的な実装で、完全なイントロスペクションが可能で、ユーザーは自由に操作できます(ミューテーションも含む)。より具体的な実装が必要な場合は、独自のMCPを作成し、クライアントが特定のクエリフィールドや変数のみを入力するように制限するツールを作成することをお勧めします。こちらを参考にしてください。

One-click Deploy
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/blurrah/mcp-graphql'

If you have feedback or need assistance with the MCP directory API, please join our Discord server