mcp-graphql-bridge

Name: mcp-graphql-bridge
Author: murilojrpereira

murilojrpereira

A generic MCP server that dynamically exposes any GraphQL API as tools for claude, cursor, oll,a tools via schema introspection — plug in your endpoint and start querying

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add graphql-bridge --env GRAPHQL_TOKEN='<GRAPHQL_TOKEN>' --env GRAPHQL_INTROSPECTION_TOKEN='<GRAPHQL_INTROSPECTION_TOKEN>' -- npx -y mcp-graphql-bridge

~/.codex/config.toml

[mcp_servers.graphql-bridge]
command = "npx"
args = ["-y", "mcp-graphql-bridge"]
env = { GRAPHQL_TOKEN = "<GRAPHQL_TOKEN>", GRAPHQL_INTROSPECTION_TOKEN = "<GRAPHQL_INTROSPECTION_TOKEN>" }

# codex mcp add graphql-bridge --env GRAPHQL_TOKEN='<GRAPHQL_TOKEN>' --env GRAPHQL_INTROSPECTION_TOKEN='<GRAPHQL_INTROSPECTION_TOKEN>' -- npx -y mcp-graphql-bridge

~/.cursor/mcp.json

{
  "mcpServers": {
    "graphql-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-graphql-bridge"
      ],
      "env": {
        "GRAPHQL_TOKEN": "<GRAPHQL_TOKEN>",
        "GRAPHQL_INTROSPECTION_TOKEN": "<GRAPHQL_INTROSPECTION_TOKEN>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "graphql-bridge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-graphql-bridge"
      ],
      "env": {
        "GRAPHQL_TOKEN": "<GRAPHQL_TOKEN>",
        "GRAPHQL_INTROSPECTION_TOKEN": "<GRAPHQL_INTROSPECTION_TOKEN>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "graphql-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-graphql-bridge"
      ],
      "env": {
        "GRAPHQL_TOKEN": "<GRAPHQL_TOKEN>",
        "GRAPHQL_INTROSPECTION_TOKEN": "<GRAPHQL_INTROSPECTION_TOKEN>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "graphql-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-graphql-bridge"
      ],
      "env": {
        "GRAPHQL_TOKEN": "<GRAPHQL_TOKEN>",
        "GRAPHQL_INTROSPECTION_TOKEN": "<GRAPHQL_INTROSPECTION_TOKEN>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "graphql-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-graphql-bridge"
      ],
      "env": {
        "GRAPHQL_TOKEN": "<GRAPHQL_TOKEN>",
        "GRAPHQL_INTROSPECTION_TOKEN": "<GRAPHQL_INTROSPECTION_TOKEN>"
      }
    }
  }
}

Environment variables

GRAPHQL_TOKEN
GRAPHQL_INTROSPECTION_TOKEN

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related