TM

toolprint/mcp-graphql-forge

Developer toolsОфициальный

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

18 stars 6 forks Качество 57 Тренд 22NOASSERTION

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-режимом (рекомендуется для разработки)

  1. ** Запустить сервер**:

  2. ** Свяжитесь с инспектором MCP**:

  3. ** С аутентификацией **

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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.

  1. 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
    
  2. Connect with MCP Inspector:

    # In another terminal, launch the inspector
    npx @modelcontextprotocol/inspector
    
  3. 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)

Открыть полный README на GitHub

Установка

npx -y @toolprint/mcp-graphql-forge
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "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" } } } }