GraphQL MCP Server logo

GraphQL MCP Server

by ctkadvisors

A strongly-typed TypeScript Model Context Protocol (MCP) server that provides seamless access to any GraphQL API through Claude AI. It allows you to easily connect Claude to your GraphQL data sources.

View on GitHub

Last updated: N/A

What is GraphQL MCP Server?

The GraphQL MCP Server is a TypeScript-based server that acts as a bridge between Claude AI and any GraphQL API. It leverages the Model Context Protocol (MCP) to expose GraphQL operations as tools within Claude, enabling natural language interaction with your data.

How to use GraphQL MCP Server?

To use the server, you need to install it either from npm or by cloning the repository. Configure the server with your GraphQL API endpoint and optional API key. Then, integrate the server into your Claude Desktop configuration by updating the claude_desktop_config.json file. Once configured, Claude will recognize the GraphQL operations as available tools.

Key features of GraphQL MCP Server

  • Strongly Typed (TypeScript)

  • Dynamic GraphQL Integration

  • Schema Introspection

  • Full Mutation Support

  • Query & Mutation Whitelisting

  • MCP Standard Compliant

  • Authentication Support

Use cases of GraphQL MCP Server

  • Connecting Claude AI to existing GraphQL APIs

  • Enabling natural language querying of GraphQL data

  • Building AI-powered applications that interact with GraphQL APIs

  • Providing a secure and controlled access point to GraphQL data for Claude

FAQ from GraphQL MCP Server

What is MCP?

MCP stands for Model Context Protocol. It's a standard that allows applications like Claude to interact with external tools and services.

How do I enable mutations?

You can enable mutations by setting the ENABLE_MUTATIONS environment variable to true in your Claude Desktop configuration.

How do I whitelist specific queries or mutations?

You can whitelist specific queries or mutations by setting the WHITELISTED_QUERIES and WHITELISTED_MUTATIONS environment variables to a JSON array string or a comma-separated list of operation names.

What happens if I don't provide a whitelist?

If no whitelist is provided for a particular operation type (queries or mutations), all operations of that type from the GraphQL schema will be available.

What license is this project under?

This project is licensed under the Business Source License 1.1 (BSL 1.1) for non-commercial and internal business use. Commercial use requires a commercial license from CTK Advisors.