빠른 설치

대안 설치 방법

GraphQL API를 AI 툴에 접근할 수 있는 MCP 서버:

• GraphQL schema introspection의 MCP 툴을 자동 생성
• 신뢰할 수있는 AI 상호 작용을위한 검증 매개 변수 및 처리 오류
• 개발 및 생산을위한 stdio 및 HTTP 운송 모두 지원
• 일관된 성능을위한 캐싱 스키마 및 필드 선택

✨ 특징

-Tool Generation: GraphQL 스키마 소개 -Parameter Validation: 다중층 검증은 GraphQL 오류를 방지합니다.

• Dual Transport: 지원 stdio (AI 도구) 및 HTTP (개발 / 테스트)
• ** 화학 관리 **: 선택적인 전선 및 캐싱
• ** 인증**: 정통 엔드포인트의 유연한 헤더 구성 [Experimental]

⭐ 시작하기

** 참고**: Docker 런타임 지원은 현재 진행 중입니다. 생산 배포를 위해, 우리는 Smithery와 같은 플랫폼에서 TypeScript 런타임을 사용하는 것이 좋습니다.

빠른 시작 HTTP 모드 (개발 권장)

1. **서버 시작 **:

2. ** MCP 검사기와 연결 **:

3. ** 인증**:

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)

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)