What is Mcp Graphql Server

mcp-graphql-server is a Model Context Protocol (MCP) server implementation that provides GraphQL API interaction capabilities, allowing AI assistants to communicate with GraphQL APIs through standardized tools.

Use cases

Use cases include building AI assistants that need to fetch data from GraphQL APIs, exploring GraphQL schemas for documentation purposes, and performing complex queries with customizable parameters.

How to use

To use mcp-graphql-server, you can run it using NPX with specific command-line arguments to set the GraphQL endpoint, headers, timeout, and query complexity. An example command is provided in the README.

Key features

Key features include executing GraphQL queries, retrieving GraphQL schema information, customizable request headers, timeout settings, and support for mutation operations.

Where to use

mcp-graphql-server can be used in various fields such as AI development, data integration, and any application that requires interaction with GraphQL APIs.

GraphQL MCP Tools

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

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.