blurrah/mcp-graphql

blurrah/mcp-graphql

от blurrah
MCP сервер для работы ИИ-агентов с GraphQL API. Автоматически извлекает схему через интроспекцию и выполняет запросы. Мутации по умолчанию отключены. Полезен при создании AI-инструментов для GraphQL.

mcp-graphql

smithery badge

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.

mcp-graphql MCP server

Usage

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

Environment Variables (Breaking change in 1.0.0)

Note: As of version 1.0.0, command line arguments have been replaced with environment variables.

Environment Variable Description Default
ENDPOINT GraphQL endpoint URL http://localhost:4000/graphql
HEADERS JSON string containing headers for requests {}
ALLOW_MUTATIONS Enable mutation operations (disabled by default) false
NAME Name of the MCP server mcp-graphql
SCHEMA Path to a local GraphQL schema file or URL (optional) -
Examples
# Basic usage with a local GraphQL server
ENDPOINT=http://localhost:3000/graphql npx mcp-graphql

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

# Enable mutation operations
ENDPOINT=http://localhost:3000/graphql ALLOW_MUTATIONS=true npx mcp-graphql

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

# Using a schema file hosted at a URL
ENDPOINT=http://localhost:3000/graphql SCHEMA=https://example.com/schema.graphql npx mcp-graphql

Часто задаваемые вопросы

Инструменты были проиндексированы:
introspect-schema

Выполните интроспекцию схемы GraphQL, используйте этот инструмент перед выполнением запроса, чтобы получить информацию о схеме, если она еще недоступна как ресурс.

Параметры
  • __ignore__boolean

    Это ничего не делает.

query-graphql

Запрашивает конечную точку GraphQL с указанными запросом и переменными.

Параметры
  • querystringобязательный
  • variablesstring
2.0.4основная
2.0.3
2.0.2
2.0.1
2.0.0
1.0.1
1.0.0
0.3.3
0.3.2
0.2.2
0.2.0
0.1.2
0.1.0
0.0.7
0.0.6
0.0.5

Выберите клиент, чтобы установить blurrah/mcp-graphql:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "blurrah-mcp-graphql-iqlk60tupm": {
      "command": "npx",
      "args": [
        "mcp-graphql"
      ],
      "env": {
        "ENDPOINT": "http://localhost:3000/graphql"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "blurrah-mcp-graphql-iqlk60tupm": {
      "command": "npx",
      "args": [
        "mcp-graphql"
      ],
      "env": {
        "ENDPOINT": "http://localhost:3000/graphql"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "blurrah-mcp-graphql-iqlk60tupm": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "mcp-graphql"
      ],
      "env": {
        "ENDPOINT": "http://localhost:3000/graphql"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"blurrah-mcp-graphql-iqlk60tupm\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"mcp-graphql\"],\"env\":{\"ENDPOINT\":\"http://localhost:3000/graphql\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "blurrah-mcp-graphql-iqlk60tupm": {
      "command": "npx",
      "args": [
        "mcp-graphql"
      ],
      "env": {
        "ENDPOINT": "http://localhost:3000/graphql"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add blurrah-mcp-graphql-iqlk60tupm --env ENDPOINT=http://localhost:3000/graphql -- npx mcp-graphql

Либо через JSON-конфиг:

claude mcp add-json blurrah-mcp-graphql-iqlk60tupm "{\"command\":\"npx\",\"args\":[\"mcp-graphql\"],\"env\":{\"ENDPOINT\":\"http://localhost:3000/graphql\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add blurrah-mcp-graphql-iqlk60tupm --env ENDPOINT=http://localhost:3000/graphql -- npx mcp-graphql

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.blurrah-mcp-graphql-iqlk60tupm]
command = "npx"
args = ["mcp-graphql"]

[mcp_servers.blurrah-mcp-graphql-iqlk60tupm.env]
ENDPOINT = "http://localhost:3000/graphql"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите blurrah/mcp-graphql, а в поле команды запуска — строку ниже:
npx mcp-graphql

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "blurrah-mcp-graphql-iqlk60tupm": {
      "command": "npx",
      "args": [
        "mcp-graphql"
      ],
      "env": {
        "ENDPOINT": "http://localhost:3000/graphql"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "blurrah-mcp-graphql-iqlk60tupm": {
      "command": "npx",
      "args": [
        "mcp-graphql"
      ],
      "env": {
        "ENDPOINT": "http://localhost:3000/graphql"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например blurrah-mcp-graphql-iqlk60tupm.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: blurrah-mcp-graphql-iqlk60tupm
    command: npx
    args:
      - "mcp-graphql"
    env:
      ENDPOINT: http://localhost:3000/graphql
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "blurrah-mcp-graphql-iqlk60tupm": {
      "command": "npx",
      "args": [
        "mcp-graphql"
      ],
      "env": {
        "ENDPOINT": "http://localhost:3000/graphql"
      }
    }
  }
}

Похожие MCP-сервера

prisma/mcp

prisma/mcp

официальный

от prisma

MCP сервер Prisma позволяет AI-агентам управлять базами данных Prisma Postgres: создавать бэкапы, выполнять SQL, интроспекцию схемы и миграции. Идеально для разработчиков, автоматизирующих работу с PostgreSQL через естественный язык.

JavaScript⭐ 49
quantgeekdev/mongo-mcp

quantgeekdev/mongo-mcp

от quantgeekdev

MCP сервер для MongoDB: LLM выполняет запросы, инспектирует схемы и управляет документами с индексами на естественном языке. Полезен разработчикам для автоматизации работы с базами данных.

TypeScript⭐ 176
davewind/mysql-mcp-server

davewind/mysql-mcp-server

от dave-wind

MCP сервер для безопасного read-only доступа к MySQL: позволяет LLM инспектировать схемы таблиц и выполнять SELECT-запросы. Автоматическое обнаружение структуры БД и строгая валидация только чтения — полезно для аналитики и интеграции.

JavaScript⭐ 16
cyberchitta/llm-context.py

cyberchitta/llm-context.py

от cyberchitta

LLM Context - MCP-сервер для умного управления контекстом при работе с ИИ. Использует правила для автоматического подбора и передачи нужных файлов проекта, экономя токены. Полезен разработчикам и A...

Python⭐ 307
AntonioTF5/soul-mcp-server

AntonioTF5/soul-mcp-server

от antoniotf5

MCP-сервер для работы с SOUL.md: валидация файлов по схеме, генерация шаблонов агентов и оценка полноты. Всё доступно из Claude Desktop или любого MCP-клиента. Полезен разработчикам AI-агентов.

JavaScript⭐ 2
furey/mongodb-lens

furey/mongodb-lens

от furey

MongoDB Lens - MCP сервер для работы с MongoDB через естественный язык. С помощью LLM выполняйте запросы, агрегации, анализируйте производительность и управляйте индексами. Полезен разработчикам и администраторам баз данных.

JavaScript⭐ 208
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин