mcp-graphql

# MCP GraphQL An MCP (Model Context Protocol) server that enables interaction with GraphQL APIs. ## Description MCP GraphQL is a tool that implements the Model Context Protocol (MCP) to provide a standardized interface for interacting with GraphQL APIs. It automatically exposes each GraphQL query as a separate MCP tool, allowing MCP-compatible clients to seamlessly communicate with GraphQL services. ## Features - Each GraphQL query is exposed as a distinct MCP tool - Tool parameters automatically match the corresponding GraphQL query parameters - JSON schema for tool inputs is dynamically generated from GraphQL query parameters - No schema definition required - simply provide the API URL and credentials - Currently supports GraphQL queries (mutations support planned for future releases) - Configurable authentication (Bearer, Basic, custom headers) - Automatic handling of complex GraphQL types ## Requirements - Python 3.11 or higher ## Installation ### Using uv (recommended) When using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will use [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *mcp-graphql*. ### Using pip Alternatively you can install `mcp-graphql` via pip: ```bash pip install mcp-graphql ``` ### Installation from source code ```bash git clone https://github.com/your-username/mcp_graphql.git cd mcp_graphql pip install . ``` ## Usage ### As a command line tool Using uvx: ```bash uvx mcp-graphql --api-url="https://api.example.com/graphql" --auth-token="your-token" ``` Using pip installation: ```bash mcp-graphql --api-url="https://api.example.com/graphql" --auth-token="your-token" ``` or ```bash python -m mcp_graphql --api-url="https://api.example.com/graphql" --auth-token="your-token" ``` ### Available options - `--api-url`: GraphQL API URL (required) - `--auth-token`: Authentication token (optional, can also be set via `MCP_AUTH_TOKEN` environment variable) - `--auth-type`: Authentication typ…