mcp-graphql

LLM이 GraphQL API와 상호작용할 수 있도록 하는 모델 컨텍스트 프로토콜 서버입니다. 이 구현은 스키마 내부 검사 및 쿼리 실행 기능을 제공하여 모델이 GraphQL API를 동적으로 검색하고 사용할 수 있도록 합니다.

용법

올바른 엔드포인트로 mcp-graphql 실행하면 자동으로 쿼리를 검사하려고 합니다.

명령줄 인수

논쟁	설명	기본
`--endpoint`	GraphQL 엔드포인트 URL	`http://localhost:4000/graphql`
`--headers`	요청에 대한 헤더를 포함하는 JSON 문자열	`{}`
`--enable-mutations`	돌연변이 작업 활성화(기본적으로 비활성화됨)	`false`
`--name`	MCP 서버의 이름	`mcp-graphql`
`--schema`	로컬 GraphQL 스키마 파일에 대한 경로(선택 사항)	-

예시

지엑스피1

사용 가능한 도구

서버는 두 가지 주요 도구를 제공합니다.

introspect-schema : 이 도구는 GraphQL 스키마를 검색합니다. 스키마에 리소스로 접근할 수 없는 경우 먼저 이 도구를 사용하세요. 로컬 스키마 파일이나 인트로스펙션 쿼리를 사용합니다.
query-graphql : 엔드포인트에 대해 GraphQL 쿼리를 실행합니다. --enable-mutations 옵션을 지정하지 않으면 기본적으로 뮤테이션 기능은 비활성화됩니다.

자원

graphql-schema : 서버는 GraphQL 스키마를 클라이언트가 액세스할 수 있는 리소스로 노출합니다. 이는 로컬 스키마 파일이거나 인트로스펙션 쿼리를 기반으로 합니다.

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 GraphQL MCP Toolkit을 자동으로 설치하려면:

npx -y @smithery/cli install mcp-graphql --client claude

수동 설치

Claude에 수동으로 설치할 수 있습니다.

{
  "mcpServers": {
    "mcp-graphql": {
      "command": "npx",
      "args": ["mcp-graphql", "--endpoint", "http://localhost:3000/graphql"]
    }
  }
}

보안 고려 사항

LLM이 데이터베이스 또는 서비스 데이터를 수정하는 것을 방지하기 위한 보안 조치로 변형은 기본적으로 비활성화되어 있습니다. 프로덕션 환경에서 변형을 활성화하기 전에 신중하게 고려하세요.

귀하의 서버에 맞게 사용자 정의하세요

이는 완전한 내부 검사가 가능하고 사용자가 원하는 모든 작업(변이 포함)을 수행할 수 있는 매우 일반적인 구현입니다. 더 구체적인 구현이 필요하다면 자체 MCP를 만들고 클라이언트가 특정 쿼리 필드 및/또는 변수만 입력하도록 도구를 제한하는 것이 좋습니다. 이 내용을 참고할 수 있습니다.

Integrations