mcp-graphql
Сервер Model Context Protocol, который позволяет LLM взаимодействовать с API GraphQL. Эта реализация обеспечивает возможности интроспекции схемы и выполнения запросов, позволяя моделям динамически обнаруживать и использовать API GraphQL.
Использование
Запустите mcp-graphql
с правильной конечной точкой, он автоматически попытается проанализировать ваши запросы.
Переменные среды (критическое изменение в версии 1.0.0)
Примечание: Начиная с версии 1.0.0 аргументы командной строки заменены переменными среды.
Переменная среды | Описание | По умолчанию |
---|---|---|
ENDPOINT | URL-адрес конечной точки GraphQL | http://localhost:4000/graphql |
HEADERS | Строка JSON, содержащая заголовки для запросов | {} |
ALLOW_MUTATIONS | Включить операции мутации (по умолчанию отключено) | false |
NAME | Имя MCP-сервера | mcp-graphql |
SCHEMA | Путь к локальному файлу схемы GraphQL (необязательно) | - |
Примеры
Ресурсы
- graphql-schema : Сервер выставляет схему GraphQL как ресурс, к которому клиенты могут получить доступ. Это либо локальный файл схемы, либо основанный на запросе интроспекции.
Доступные инструменты
Сервер предоставляет два основных инструмента:
- introspect-schema : Этот инструмент извлекает схему GraphQL. Используйте его в первую очередь, если у вас нет доступа к схеме как к ресурсу. Он использует либо локальный файл схемы, либо запрос интроспекции.
- query-graphql : Выполнение запросов GraphQL к конечной точке. По умолчанию мутации отключены, если
ALLOW_MUTATIONS
не установлен вtrue
.
Установка
Установка через Smithery
Чтобы автоматически установить GraphQL MCP Server для Claude Desktop через Smithery :
Установка вручную
Его можно вручную установить на Клода:
Соображения безопасности
Мутации отключены по умолчанию в качестве меры безопасности, чтобы не дать LLM изменить вашу базу данных или данные сервиса. Тщательно подумайте, прежде чем включать мутации в производственных средах.
Настройте под свой сервер
Это очень общая реализация, которая позволяет проводить полную интроспекцию и делать что угодно для ваших пользователей (включая мутации). Если вам нужна более конкретная реализация, я бы предложил просто создать свой собственный MCP и заблокировать вызов инструмента для клиентов, чтобы они вводили только определенные поля запроса и/или переменные. Вы можете использовать это в качестве справочного материала.
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
MCP для работы с серверами GraphQL.
Related MCP Servers
- -securityFlicense-qualityAn MCP server that enables graph database interactions with Neo4j, allowing users to access and manipulate graph data through natural language commands.Last updated -Python
- -securityAlicense-qualityA MCP server that exposes GraphQL schema information to LLMs like Claude. This server allows an LLM to explore and understand large GraphQL schemas through a set of specialized tools, without needing to load the whole schema into the contextLast updated -5826JavaScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server that connects GraphDB's SPARQL endpoints and Ollama models to Claude, enabling Claude to query and manipulate ontology data while leveraging various AI models.Last updated -281TypeScriptMIT License
- PythonApache 2.0