graphql-mcp-bridge은(는) 무엇을 하나요?
🌉 GraphQL API를 모델 컨텍스트 프로토콜(Model Context Protocol)과 완벽하게 연결하여 데이터 관리 및 통합을 향상시킵니다.
개요
이 브리지는 AI 에이전트(예: Claude Code, Cursor 등)가 GraphQL API와 직접 통신할 수 있도록 해주는 MCP 서버입니다. 개발자는 복잡한 쿼리 작성 없이 자연어로 데이터를 요청하고 조작할 수 있습니다.
주요 기능
- 스키마 탐색: 연결된 GraphQL API의 스키마를 자동으로 탐색하여 사용 가능한 타입, 쿼리, 뮤테이션을 제공합니다.
- 자연어 쿼리: 자연어 명령을 GraphQL 쿼리로 변환하여 실행합니다.
- 뮤테이션 지원: 데이터 생성, 업데이트, 삭제 작업을 자연어로 수행합니다.
- 결과 캐싱: 자주 요청되는 데이터를 캐싱하여 응답 시간을 단축합니다.
- 오류 처리: GraphQL 오류를 사용자 친화적인 메시지로 변환하여 제공합니다.
설치
npm install @zcebupelka/graphql-mcp-bridge
# 또는
pip install graphql-mcp-bridge
설정
mcp.json 파일에 다음 구성을 추가하세요:
{
"mcpServers": {
"graphql-bridge": {
"command": "node",
"args": ["-e", "require('@zcebupelka/graphql-mcp-bridge')"],
"env": {
"GRAPHQL_ENDPOINT": "https://your-graphql-api.com/graphql",
"GRAPHQL_API_KEY": "your-api-key"
}
}
}
}
사용 예시
스키마 탐색
사용자: "데이터베이스에서 사용 가능한 모든 유형을 나열해줘" 에이전트: GraphQL 스키마를 탐색하여 사용자(User), 게시물(Post), 댓글(Comment) 등의 타입을 반환합니다.
데이터 쿼리
사용자: "최근 게시물 5개를 작성자와 함께 가져와줘" 에이전트: 다음 GraphQL 쿼리를 생성하고 실행합니다:
query {
posts(last: 5) {
title
content
author {
name
email
}
}
}
데이터 조작
사용자: "새 게시물을 생성해줘. 제목은 'Hello World', 내용은 '내 첫 게시물입니다.'" 에이전트: 뮤테이션을 실행하여 새 게시물을 생성합니다.
mutation {
createPost(input: {title: "Hello World", content: "내 첫 게시물입니다."}) {
id
title
createdAt
}
}
지원 환경
- Claude Desktop: 구성 파일을 통해 직접 통합 가능
- Cursor: MCP 구성으로 추가 가능
- Codex: 플러그인 또는 확장 기능으로 사용 가능
- 기타 MCP 클라이언트: 표준 MCP 프로토콜을 지원하는 모든 도구
라이선스
MIT