License

Skip to content

You signed in with another tab or window. Reload
to refresh your session. You signed out in another tab or window. Reload
to refresh your session. You switched accounts on another tab or window. Reload
to refresh your session. Dismiss alert

blurrah / mcp-graphql Public

• Notifications
  You must be signed in to change notification settings

• Fork 8

• Star 48

Model Context Protocol server for GraphQL

License

MIT license

48 stars
8 forks
Branches
Tags
Activity

Star

Notifications
You must be signed in to change notification settings

blurrah/mcp-graphql

main

3 Branches
14 Tags

Go to file

Code

Folders and files

| Name | | Name | Last commit message | Last commit date |
| --- | --- | --- | --- |
| Latest commit
-------------


blurrah

release: 0.3.2 with optional endpoints and headers

Mar 13, 2025

6e3ff6f
 · Mar 13, 2025

History
-------

53 Commits

| | |
| .github/workflows | | .github/workflows | | |
| .vscode | | .vscode | | |
| dev | | dev | | |
| src | | src | | |
| .gitattributes | | .gitattributes | | |
| .gitignore | | .gitignore | | |
| .npmrc | | .npmrc | | |
| CONTRIBUTING.md | | CONTRIBUTING.md | | |
| Dockerfile | | Dockerfile | | |
| LICENSE | | LICENSE | | |
| README.md | | README.md | | |
| biome.json | | biome.json | | |
| bun.lockb | | bun.lockb | | |
| package.json | | package.json | | |
| smithery.yaml | | smithery.yaml | | |
| tsconfig.json | | tsconfig.json | | |
| View all files | | |

Repository files navigation

mcp-graphql

A Model Context Protocol server that enables LLMs to interact with GraphQL APIs. This implementation provides schema introspection and query execution capabilities, allowing models to discover and use GraphQL APIs dynamically.

Usage

Run mcp-graphql with the correct endpoint, it will automatically try to introspect your queries.

Command Line Arguments

Examples

# Basic usage with a local GraphQL server
npx mcp-graphql --endpoint http://localhost:3000/graphql

# Using with custom headers
npx mcp-graphql --endpoint https://api.example.com/graphql --headers '{"Authorization":"Bearer token123"}'

# Enable mutation operations
npx mcp-graphql --endpoint http://localhost:3000/graphql --enable-mutations

# Using a local schema file instead of introspection
npx mcp-graphql --endpoint http://localhost:3000/graphql --schema ./schema.graphql

Available Tools

The server provides two main tools:

1. introspect-schema: This tool retrieves the GraphQL schema. Use this first if you don't have access to the schema as a resource. This uses either the local schema file or an introspection query.

2. query-graphql: Execute GraphQL queries against the endpoint. By default, mutations are disabled unless --enable-mutations is specified.

Resources

• graphql-schema: The server exposes the GraphQL schema as a resource that clients can access. This is either the local schema file or based on an introspection query.

Installation

Installing via Smithery

To install GraphQL MCP Server for Claude Desktop automatically via Smithery
:

npx -y @smithery/cli install mcp-graphql --client claude

Installing Manually

It can be manually installed to Claude:

{
    "mcpServers": {
        "mcp-graphql": {
            "command": "npx",
            "args": ["mcp-graphql", "--endpoint", "http://localhost:3000/graphql"]
        }
    }
}

Security Considerations

Mutations are disabled by default as a security measure to prevent an LLM from modifying your database or service data. Consider carefully before enabling mutations in production environments.

Customize for your own server

This is a very generic implementation where it allows for complete introspection and for your users to do whatever (including mutations). If you need a more specific implementation I'd suggest to just create your own MCP and lock down tool calling for clients to only input specific query fields and/or variables. You can use this as a reference.

About

Model Context Protocol server for GraphQL

Topics

ai
mcp
llm
mcp-server
modelcontextprotocol

Resources

Readme

License

MIT license

Activity

Stars

48 stars

Watchers

2 watching

Forks

8 forks

Report repository

Releases 14

v0.3.2 Latest\
\
Mar 13, 2025

+ 13 releases

Packages 0

No packages published

Contributors 4

• 
  blurrah Boris Besemer

• 
  calclavia Henry Mao

• 
  takumiyoshikawa

• 
  punkpeye Frank Fiegel

Languages

• TypeScript 95.3%

• Dockerfile 4.7%

You can’t perform that action at this time.