
    ==================
      
       /// MCP ///
      /// MCP ///
        
    ==================
        
    [server:online]
    [protocol:ready]

mcp-graphql

by blurrah

Model Context Protocol server that lets LLMs discover, introspect and query arbitrary GraphQL APIs.

241

Open Source

Retrieve the GraphQL schema, using either a local schema file or an introspection query.

Execute GraphQL queries against the configured endpoint; mutations are disabled unless ALLOW_MUTATIONS is set to true.

Installation

1. Prerequisites

• Node.js ≥ 18

• npm (or pnpm/yarn)

• An OpenAI-compatible key (or other LLM provider key) exported as OPENAI_API_KEY in your shell or placed in a .env file.

2. Get the source

git clone https://github.com/blurrah/mcp-graphql.git
cd mcp-graphql

3. Install dependencies

npm install # or pnpm install / yarn install

4. Build TypeScript → JavaScript

npm run build # compiles to ./dist

5. Configure (optional)

• Copy .env.example to .env and adjust:

• Add any provider-specific keys if you plan to use Anthropic, Groq etc.

OPENAI_API_KEY=<your-key>
PORT=3000               # default
MODEL=gpt-4o-mini       # default model name

6. Run the server

npm start # or: node dist/index.js

7. Access

• GraphQL IDE: http://localhost:3000/graphql

• MCP REST: http://localhost:3000/v1/[route]

8. Docker (optional)

docker build -t mcp-graphql .
docker run -p 3000:3000 -e OPENAI_API_KEY=sk-... mcp-graphql

License: MIT License

Updated 7/30/2025