Skip to main content
Glama
Sign In
deenesjakoruzh

mcp-graphql

by blurrah
npmGitHub
TypeScript
MIT License
733
170
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

mcp-graphql

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

使用法

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

環境変数（1.0.0 での重大な変更）

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

環境変数説明デフォルト
ENDPOINTGraphQLエンドポイントURLhttp://localhost:4000/graphql
HEADERSリクエストのヘッダーを含むJSON文字列{}
ALLOW_MUTATIONS突然変異操作を有効にする（デフォルトでは無効）false
NAMEMCPサーバーの名前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

リソース

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

利用可能なツール

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

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

インストール

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を作成し、クライアントが特定のクエリフィールドや変数のみを入力するように制限するツールを作成することをお勧めします。こちらを参考にしてください。

You must be authenticated.

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

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

GraphQL サーバーを操作するための MCP。

  1. 使用法
    1. 環境変数（1.0.0 での重大な変更）
    2. 例
  2. リソース
    1. 利用可能なツール
      1. インストール
        1. Smithery経由でインストール
        2. 手動でインストールする
      2. セキュリティに関する考慮事項
        1. 独自のサーバーに合わせてカスタマイズ

          Related MCP Servers

          • Neo4j MCP Server

            ujjalcal
            -
            security
            F
            license
            -
            quality
            An MCP server that enables graph database interactions with Neo4j, allowing users to access and manipulate graph data through natural language commands.
            Last updated -
            Python

          • mcp-graphql-schema

            hannesj
            -
            security
            A
            license
            -
            quality
            A MCP server that exposes GraphQL schema information to LLMs like Claude. This server allows an LLM to explore and understand large GraphQL schemas through a set of specialized tools, without needing to load the whole schema into the context
            Last updated -
            58
            26
            JavaScript
            MIT License
            • Apple
            • Linux

          • Ontology MCP

            bigdata-coss
            A
            security
            A
            license
            A
            quality
            A Model Context Protocol (MCP) server that connects GraphDB's SPARQL endpoints and Ollama models to Claude, enabling Claude to query and manipulate ontology data while leveraging various AI models.
            Last updated -
            28
            1
            TypeScript
            MIT License
            • Apple
            • Linux

          View all related MCP servers

          Appeared in Searches

          New MCP Servers

          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