Кратко
Соедини любой GraphQL API с Протоколом Модельного Контекста. Позвольте AI-агентам запрашивать и изменять данные через GraphQL конечные точки с использованием AnythingMCP.
GraphQL и MCP: Естественное Сочетание
Типизированная схема GraphQL и его самодокументируемая природа делают его идеальным источником для генерации инструментов MCP. AnythingMCP использует интроспекцию GraphQL для автоматического создания хорошо типизированных инструментов MCP из твоих запросов и мутаций.
Почему преобразовывать GraphQL в MCP?
Хотя GraphQL мощен для разработчиков, AI-агентам нужен протокол MCP для взаимодействия с инструментами. Преобразовав GraphQL в MCP, ты позволяешь AI-агентам:
- Запрашивать данные с использованием естественного языка вместо написания GraphQL запросов
- Выполнять мутации безопасно с проверенными параметрами
- Навигировать по отношениям без понимания обхода графа
Пошаговое руководство
Шаг 1: Разверни AnythingMCP
Клонируйте репозиторий и запусти приложение с помощью Docker Compose:
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Это запускает PostgreSQL, бэкенд API (порт 4000) и панель управления (порт 3000).
Шаг 2: Создай GraphQL Коннектор
Открой панель управления AnythingMCP по адресу http://localhost:3000 и создай новый GraphQL коннектор. Укажи URL конечной точки GraphQL — AnythingMCP будет использовать интроспекцию для автоматического обнаружения полной схемы, включая все запросы, мутации и типы.
Шаг 3: Интроспекция Схемы
AnythingMCP автоматически интроспектирует твою схему GraphQL и генерирует инструменты MCP:
- Запросы становятся инструментами MCP только для чтения
- Мутации становятся инструментами MCP для записи
- Типы ввода становятся параметрами инструмента с правильной проверкой
- Типы перечислений становятся ограничениями параметров
Шаг 4: Настройка Аутентификации
В настройках коннектора настрой аутентификацию для твоего GraphQL API. AnythingMCP поддерживает токены Bearer, API ключи и пользовательские заголовки. Переменные окружения могут использоваться для секретов.
Шаг 5: Настройка и Тестирование
На панели управления просмотри каждый сгенерированный инструмент, настрой имена и описания, а также выбери, какие операции сделать доступными. Используй встроенный интерфейс тестирования для выполнения операций и проверки ответов.
Шаг 6: Подключение к AI Агентам
Настрой твой MCP клиент для подключения к серверу AnythingMCP:
{
"mcpServers": {
"my-graphql-api": {
"url": "http://localhost:4000/mcp"
}
}
}
Популярные GraphQL API для Подключения
| Сервис | Случай использования |
|---|---|
| GitHub | Управление репозиториями и задачами |
| Shopify | Операции электронной коммерции |
| Hasura | Доступ к базе данных |
| Contentful | Управление контентом |
| Strapi | Headless CMS |
Лучшие Практики
- Включи интроспекцию — Убедись, что твоя конечная точка GraphQL позволяет запросы интроспекции
- Начни с запросов — Сначала открой операции чтения, затем добавь мутации
- Упрощайте вложенные ответы — Настрой, какие поля включать в ответы инструмента
- Ограничение скорости — Настрой ограничения скорости, чтобы избежать перегрузки сервера GraphQL
Следующие Шаги
- Руководство по REST в MCP — Преобразование REST API
- Руководство по базе данных в MCP — Прямой доступ к базе данных
Это руководство помогло?
