Graphql

🚀 GraphQL MCP Tools Server

A Model Context Protocol (MCP) server implementation that provides GraphQL API interaction capabilities. This server enables AI assistants to interact with GraphQL APIs through a set of standardized tools.

🚀 Quick Start

This is a Model Context Protocol (MCP) server implementation that offers GraphQL API interaction capabilities, allowing AI assistants to interact with GraphQL APIs via a set of standardized tools.

✨ Features

Tools

• graphql_query

  • Execute GraphQL queries on any endpoint.
  • Inputs:
    • query (string): The GraphQL query to be executed.
    • variables (object, optional): Query variables.
    • endpoint (string, optional): The GraphQL endpoint URL.
    • headers (object, optional): HTTP headers for the request.
    • timeout (number, optional): Request timeout in milliseconds.
    • allowMutations (boolean, optional): Whether to allow mutation operations.

• graphql_introspect

  • Retrieve and explore GraphQL schema information.
  • Inputs:
    • endpoint (string, optional): The GraphQL endpoint URL.
    • headers (object, optional): HTTP headers for the request.
    • includeDeprecated (boolean, optional): Whether to include deprecated types/fields.

💻 Usage Examples

Basic Usage

Here is an NPX example when using Claude Desktop:

{
  "mcpServers": {
    "graphql": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-graphql-tools",
        "--endpoint=https://api.github.com/graphql",
        "--headers={\"Authorization\":\"Bearer YOUR_GITHUB_TOKEN\"}",
        "--timeout=30000",
        "--maxComplexity=100"
      ]
    }
  }
}

📚 Documentation

Configuration Options

The server accepts the following command-line arguments:

📄 License

This MCP server is distributed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please refer to the LICENSE file in the project repository.