mcp4gql - GraphQL MCP 서버

이 프로젝트는 모델 컨텍스트 프로토콜(MCP)을 구현하는 Node.js/TypeScript 서버입니다. MCP 클라이언트(예: Cursor)가 대상 GraphQL API와 상호 작용할 수 있도록 하는 브릿지 역할을 합니다.

특징

• MCP 서버: @modelcontextprotocol/sdk 의 MCP Server 클래스를 구현합니다.

• 표준 입출력 (Stdio Transport): 표준 입출력을 통해 클라이언트와 통신합니다.

• GraphQL 클라이언트: axios 사용하여 구성된 GraphQL 엔드포인트에 요청을 보냅니다.

• 일반 GraphQL 도구: 다음 도구를 MCP 클라이언트에 제공합니다.

  • introspectGraphQLSchema : 인트로스펙션을 사용하여 대상 GraphQL API 스키마를 가져옵니다.

  • executeGraphQLOperation : query , 선택적 variables , 선택적 operationName 입력으로 받아 대상 API에 대해 임의의 GraphQL 쿼리나 뮤테이션을 실행합니다.

Related MCP server: mcp-graphql-schema

구성

서버에는 다음과 같은 환경 변수가 필요합니다.

• GRAPHQL_ENDPOINT : 대상 GraphQL API의 URL입니다.

• AUTH_TOKEN : GraphQL API 인증을 위한 선택적 Authorization: Bearer <token> 헤더에 대한 전달자 토큰입니다.

클라이언트 구성

Cursor나 Claude Desktop과 같은 클라이언트가 이 서버에서 제공하는 도구를 사용할 수 있게 하려면 npx 명령을 실행하도록 구성해야 합니다.

커서

1. 커서 MCP 설정으로 이동하세요(커서 > 설정 > 커서 설정 > MCP)

2. • 새로운 글로벌 MCP 서버 추가로 이동

3. 커서 MCP 구성에 다음을 추가하세요.

   지엑스피1

클로드 데스크탑

1. Claude Desktop 설정을 엽니다(Claude > 설정).

2. 개발자 > 구성 편집으로 이동합니다.

3. 구성에 추가:

   { "mcpServers": { "mcp4gql": { "command": "npx", "args": ["-y", "mcp4gql"], "env": { "GRAPHQL_ENDPOINT": "YOUR_GRAPHQL_ENDPOINT_URL", "AUTH_TOKEN": "YOUR_OPTIONAL_AUTH_TOKEN" } } } }

구성이 완료되면 MCP 클라이언트는 해당 서버에서 제공하는 introspectGraphQLSchema 및 executeGraphQLOperation 도구를 나열하고 호출할 수 있어야 합니다(해당하는 경우). 서버가 API에 연결할 수 있도록 구성에서 필수 환경 변수( GRAPHQL_ENDPOINT 및 선택적으로 AUTH_TOKEN )를 설정해야 합니다.