MCP.so
ログイン

mcp-graphql

@blurrah

mcp-graphql について

Model Context Protocol server for GraphQL

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

node

トランスポート

stdio

公開者

blurrah

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is mcp-graphql?

mcp-graphql is a Model Context Protocol (MCP) server that enables LLMs to interact with GraphQL APIs. It provides schema introspection and query execution capabilities, allowing models to dynamically discover and use any GraphQL endpoint.

How to use mcp-graphql?

Set environment variables (ENDPOINT, HEADERS, ALLOW_MUTATIONS, NAME, SCHEMA) and run npx mcp-graphql. The server automatically introspects the schema and exposes tools for querying. It can be installed via Smithery or configured manually for Claude Desktop.

Key features of mcp-graphql

  • Schema introspection via introspect-schema tool or graphql-schema resource
  • Execute GraphQL queries with the query-graphql tool
  • Support for custom headers (e.g., authentication tokens)
  • Option to provide a local or remote schema file instead of introspection
  • Mutations disabled by default for security; enable with ALLOW_MUTATIONS=true

Use cases of mcp-graphql

  • LLM agents that need to query or modify data through a GraphQL API
  • Dynamic discovery of GraphQL schema for building context-aware responses
  • Testing or exploring GraphQL endpoints without writing custom code

FAQ from mcp-graphql

What does mcp-graphql do?

It acts as a bridge between LLMs (via the MCP protocol) and any GraphQL endpoint, enabling schema discovery and query execution.

How is mcp-graphql installed?

It can be installed automatically via Smithery (npx -y @smithery/cli install mcp-graphql --client claude) or manually by adding to Claude Desktop configuration with npx mcp-graphql and environment variables.

What dependencies does mcp-graphql require?

No special dependencies beyond Node.js; it runs via npx from the npm package.

How are authentication credentials handled?

Custom HTTP headers can be passed as a JSON string via the HEADERS environment variable, e.g., HEADERS='{"Authorization":"Bearer token123"}'.

Are GraphQL mutations allowed by default?

No, mutations are disabled by default as a security measure to prevent unintended database changes. Set ALLOW_MUTATIONS=true to enable them.

コメント

「その他」の他のコンテンツ