mcp-graphql

Model Context Protocol server for working with GraphQL servers. It's a simple implementation using an introspection query to read the schema and one tool to query your server.

Usage

Run mcp-graphql with the correct endpoint, it will automatically try to introspect your queries. You can optionally add a JSON string containing headers if needed.

# Example using a local GraphQL server which also publicly outputs the GraphQL schema
mcp-graphql --endpoint http://localhost:3000/graphql --headers '{"X-Custom-Header":"foobar"}'

It can be manually installed to Claude:

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

Smithery/Zed extensions will be available in the near future.

Customize for your own server

This is a very generic implementation where it allows for complete introspection and for your users to do whatever (including mutations). If you need a more specific implementation I'd suggest to just create your own MCP and lock down tool calling for clients to only input specific query fields and/or variables. You can use this as a reference.

Development

To install dependencies:

bun install

To run for development:

bun dev

To build:

bun run build