mcp-graphql
@blurrah
About mcp-graphql
Model Context Protocol server for GraphQL
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mcp-graphql": {
"command": "npx",
"args": [
"mcp-graphql"
],
"env": {
"ENDPOINT": "http://localhost:3000/graphql"
}
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
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-schematool orgraphql-schemaresource - Execute GraphQL queries with the
query-graphqltool - 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.
More Other MCP servers
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
Inbox Zero AI MCP
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
IDA Pro MCP
mrexodiaAI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.
Awesome Mlops
visengerA curated list of references for MLOps
🚀 Model Context Protocol (MCP) Curriculum for Beginners
microsoftThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,
Comments