Package Exports

mcp-graphql-tools
mcp-graphql-tools/build/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (mcp-graphql-tools) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

GraphQL MCP 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.

Components

Tools

graphql_query
- Execute GraphQL queries against any endpoint
- Input:
  - query (string): The GraphQL query to execute
  - variables (object, optional): Variables for the query
  - endpoint (string, optional): 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
- Input:
  - endpoint (string, optional): GraphQL endpoint URL
  - headers (object, optional): HTTP headers for the request
  - includeDeprecated (boolean, optional): Whether to include deprecated types/fields

Usage with Claude Desktop

Docker

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

For better security, use environment variables for authentication tokens:

{
  "mcpServers": {
    "graphql": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "GITHUB_TOKEN",
        "mcp/graphql",
        "--endpoint=https://api.github.com/graphql",
        "--timeout=30000",
        "--maxComplexity=100"
      ]
    }
  }
}

NPX

{
  "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"
      ]
    }
  }
}

Configuration Options

The server accepts the following command-line arguments:

--endpoint (-e): Default GraphQL endpoint URL (default: http://localhost:4000/graphql)
--headers (-H): Default headers for all requests as JSON string
--timeout (-t): Default request timeout in milliseconds (default: 30000)
--maxComplexity (-m): Maximum allowed query complexity (default: 100)

License

This MCP server is licensed 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 see the LICENSE file in the project repository.