Server facts
mcp-graphql
Project
- Author
- blurrah
- Repository
- github.com/blurrah/mcp-graphql
- License
- MIT
- Category
- MCP Gateways & Proxies
Tech
- Runtime / language
- node
- Transports
- stdio
- Remote available
- No
- Authentication
- Not specified
Activity
- GitHub stars
- 408
- Last commit
- Data as of
Tags
- ai
- llm
- mcp
- mcp server
- modelcontextprotocol
Overview
GraphQL schema discovery comes before query execution in mcp-graphql’s tool workflow. An LLM client can inspect the API through the graphql-schema resource or request schema information with introspect-schema when that resource is not already available. Schema information can come from endpoint introspection, a local file, or a file hosted at a URL. With that context, query-graphql sends queries and their variables to the configured GraphQL endpoint. This gives developers a way to expose GraphQL APIs to model-driven clients through MCP.
Configuration uses environment variables for the endpoint, request headers, server name, optional schema source, and mutation setting. HEADERS accepts a JSON string, while SCHEMA selects a file path or URL as an alternative to introspection. Mutation operations remain disabled by default; enabling them requires setting ALLOW_MUTATIONS to true. The project documents both manual Claude configuration and installation for Claude Desktop through Smithery. It runs on Node, communicates over stdio, and uses the MIT license.
mcp-graphql setup notes
- mcp-graphql records stdio only; confirm a network transport upstream before planning remote access.