mcp-graphql

Name: mcp-graphql
Author: blurrah

@blurrah

代码仓库

关于 mcp-graphql

Model Context Protocol server for GraphQL

#ai #mcp #llm #mcp-server #modelcontextprotocol

基本信息

分类

其他

许可证

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.

其他分类下的更多 MCP 服务器

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K