This server allows MCP clients to interact with a target GraphQL API via Model Context Protocol (MCP).
Fetch GraphQL Schema: Use
introspectGraphQLSchemato retrieve the schema of the target API in JSON formatExecute Queries/Mutations: Use
executeGraphQLOperationto send arbitrary GraphQL queries or mutations with optional variables and operation nameAuthentication Support: Optional bearer token authentication for secure API access
MCP Integration: Seamlessly connect MCP clients (like Cursor or Claude Desktop) to the server
Uses Axios to send requests to GraphQL endpoints, allowing for authenticated API interactions with configurable authorization tokens.
Acts as a bridge to any GraphQL API, providing tools to introspect schemas and execute arbitrary queries or mutations against the target GraphQL endpoint.
Built on Node.js to implement the Model Context Protocol server functionality, enabling GraphQL API interactions through standard I/O.
Implemented in TypeScript, providing type-safe interactions with GraphQL APIs through the MCP interface.
mcp4gql - GraphQL MCP Server
This project is a Node.js/TypeScript server that implements the Model Context Protocol (MCP). It acts as a bridge, allowing MCP clients (like Cursor) to interact with a target GraphQL API.
Features
MCP Server: Implements the MCP
Serverclass from@modelcontextprotocol/sdk.Stdio Transport: Communicates with clients via standard input/output.
GraphQL Client: Uses
axiosto send requests to the configured GraphQL endpoint.Generic GraphQL Tools: Exposes the following tools to MCP clients:
introspectGraphQLSchema: Fetches the target GraphQL API schema using introspection.executeGraphQLOperation: Executes arbitrary GraphQL queries or mutations against the target API, takingquery, optionalvariables, and optionaloperationNameas input.
Related MCP server: mcp-graphql-schema
Configuration
The server requires the following environment variables:
GRAPHQL_ENDPOINT: The URL of the target GraphQL API.AUTH_TOKEN: A bearer token for an optionalAuthorization: Bearer <token>header for authenticating with the GraphQL API.
Client Configuration
To allow clients like Cursor or Claude Desktop to use the tools provided by this server, you need to configure them to run the npx command.
Cursor
Go to Cursor MCP Settings (Cursor > Settings > Cursor Settings > MCP)
Go to + Add new global MCP server
Add the following to your Cursor MCP configuration:
{ "mcpServers": { "mcp4gql": { "command": "npx", "type": "stdio", "args": ["-y", "mcp4gql"], "env": { "GRAPHQL_ENDPOINT": "YOUR_GRAPHQL_ENDPOINT_URL", "AUTH_TOKEN": "YOUR_OPTIONAL_AUTH_TOKEN" } } } }
Claude Desktop
Open Claude Desktop settings (Claude > Settings).
Go to Developer > Edit Config.
Add to the config:
{ "mcpServers": { "mcp4gql": { "command": "npx", "args": ["-y", "mcp4gql"], "env": { "GRAPHQL_ENDPOINT": "YOUR_GRAPHQL_ENDPOINT_URL", "AUTH_TOKEN": "YOUR_OPTIONAL_AUTH_TOKEN" } } } }
Once configured, the MCP client should be able to list and call the introspectGraphQLSchema and executeGraphQLOperation tools provided by this server when relevant. Remember to set the required environment variables (GRAPHQL_ENDPOINT and optionally AUTH_TOKEN) in the configuration so the server can connect to your API.