
Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
MCP, который может прокси-сервер любого API GraphQL и выставлять операции graphql в качестве инструментов mcp.
Обзор
Сервер MCP, который делает API GraphQL доступными для инструментов ИИ: - Автоматическое генерирование инструментов MCP из интроспекции схемы GraphQL - Валидация параметров и ошибок обработки для надежных взаимодействий ИИ - Поддержка как стио, так и HTTP-транспорта для разработки и производства - Схема кэширования и выбор полей для последовательной производительности - Создает инструменты MCP из интроспекции схемы GraphQL - : Многоуровневая валидация предотвращает ошибки GraphQL - : Поддерживает stdio (инструменты искусственного интеллекта) и HTTP (разработка / тестирование) - : Факультативная предварительная интроспекция и кэширование - : Гибкая конфигурация заголовка для аутентифицированных конечных точек [Экспериментальный] Поддержка Docker Runtime в настоящее время находится в стадии разработки. Для развертывания производства мы рекомендуем использовать время выполнения TypeScript на таких платформах, как Smithery. Создайте mcp.json в корне проекта. Это будет работать в режиме.
Обзор (машинный перевод)
Быстрая установка
Альтернативные методы установки
Сервер MCP, который делает API GraphQL доступными для инструментов ИИ:
- Автоматическое генерирование инструментов MCP из интроспекции схемы GraphQL Проверка параметров и ошибок обработки для надежных взаимодействий ИИ Поддержка как стдио, так и HTTP-транспорта для разработки и производства
- Схема кэширования и выбор полей для последовательной работы
Feature Особенности
** Поколение инструментов**: Создает инструменты MCP из интроспекции схемы GraphQL Параметрическая валидация: многоуровневая валидация предотвращает ошибки GraphQL Dual Transport: Поддержка stdio (инструменты искусственного интеллекта) и HTTP (разработка/тестирование) Управление схемой: Необязательная предварительная интроспекция и кэширование Аутентификация: Гибкая конфигурация заголовка для аутентифицированных конечных точек
Начало работы
Примечание: Поддержка Docker Runtime в настоящее время находится в стадии разработки. Для развертывания производства мы рекомендуем использовать время выполнения TypeScript на таких платформах, как Smithery.
Быстрый старт с HTTP-режимом (рекомендуется для разработки)
-
** Запустить сервер**:
-
** Свяжитесь с инспектором MCP**:
-
** С аутентификацией **
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
MCP GraphQL Forge
Quick Install
Alternative Installation Methods
# Via Smithery (recommended)
npx @smithery/cli install @toolprint/mcp-graphql-forge --client claude
# Via npm
npm install -g @toolprint/mcp-graphql-forge
An MCP server that makes GraphQL APIs accessible to AI tools by:
- Automatically generating MCP tools from GraphQL schema introspection
- Validating parameters and handling errors for reliable AI interactions
- Supporting both stdio and HTTP transports for development and production
- Caching schema and field selections for consistent performance
✨ Features
- Tool Generation: Creates MCP tools from GraphQL schema introspection
- Parameter Validation: Multi-layer validation prevents GraphQL errors
- Dual Transport: Supports stdio (AI tools) and HTTP (development/testing)
- Schema Management: Optional pre-introspection and caching
- Authentication: Flexible header configuration for authenticated endpoints [Experimental]
🚀 Getting Started
Note: Docker runtime support is currently a work in progress. For production deployments, we recommend using the TypeScript runtime on platforms like Smithery.
Quick Start with HTTP Mode (Recommended for Development)
-
Start the server:
# Start serving it with the Streamable HTTP transport GRAPHQL_ENDPOINT="https://your-api.com/graphql" npx -y @toolprint/mcp-graphql-forge --transport http --port 3001 -
Connect with MCP Inspector:
# In another terminal, launch the inspector npx @modelcontextprotocol/inspector -
With authentication:
# Using environment variables for configuration export GRAPHQL_ENDPOINT="https://api.github.com/graphql" export GRAPHQL_AUTH_HEADER="Bearer YOUR_TOKEN" npx @toolprint/mcp-graphql-forge --transport http --port 3001 # Or all in one line GRAPHQL_ENDPOINT="https://api.github.com/graphql" GRAPHQL_AUTH_HEADER="Bearer YOUR_TOKEN" npx @toolprint/mcp-graphql-forge --transport http --port 3001
Direct AI Integration (Claude/Cursor)
Установка
npx -y @toolprint/mcp-graphql-forgeКонфигурация
{
"mcpServers": {
"mcp-graphql-forge": {
"command": "npx",
"args": [
"-y",
"@toolprint/mcp-graphql-forge"
],
"env": {
"GRAPHQL_ENDPOINT": "https://your-api.com/graphql",
"GRAPHQL_AUTH_HEADER": "Bearer YOUR_TOKEN"
}
}
}
}