apollo-mcp-server은(는) 무엇을 하나요?
Apollo MCP 서버를 사용하여 AI 에이전트를 GraphQL API에 연결하는 방법을 안내합니다. 이 스킬은 다음 상황에서 사용합니다: (1) Apollo MCP 서버 설정 또는 구성, (2) GraphQL 연산에서 MCP 도구 정의, (3) 인트로스펙션 도구(introspect, search, validate, execute) 사용, (4) MCP 서버 연결 또는 도구 실행 문제 해결.
개요
Apollo MCP 서버는 MCP(Model Context Protocol)를 구현하여 AI 에이전트가 GraphQL API와 상호 작용할 수 있도록 합니다. 이 서버는 GraphQL 스키마를 자동으로 분석하여 인트로스펙션, 스키마 검색, 쿼리 유효성 검사, 연산 실행 도구를 제공합니다.
설치
npx @apollo/mcp-server
설정
환경 변수를 사용하여 Apollo MCP 서버를 구성합니다:
| 변수명 | 설명 | 필수 |
|---|---|---|
APOLLO_API_KEY | Apollo GraphQL API 키 | 아니오 |
GRAPHQL_ENDPOINT | GraphQL API 엔드포인트 URL | 예 |
MCP_PORT | MCP 서버 포트 (기본값: 8080) | 아니오 |
도구
Apollo MCP 서버는 다음 MCP 도구를 제공합니다:
introspect
GraphQL 스키마를 인트로스펙션하여 타입, 필드, 스키마 구조를 반환합니다.
search
스키마에서 타입 또는 필드를 검색합니다. 인수:
query: 검색어 (필수)
validate
제공된 GraphQL 쿼리 문자열의 유효성을 검사합니다. 인수:
query: 검사할 GraphQL 쿼리 문자열 (필수)
execute
GraphQL 연산(쿼리 또는 뮤테이션)을 실행합니다. 인수:
query: 실행할 GraphQL 연산 문자열 (필수)variables: 연산 변수 (선택 사항, JSON 문자열)
사용 예시
인트로스펙션
{
"name": "introspect"
}
스키마 검색
{
"name": "search",
"arguments": {
"query": "User"
}
}
쿼리 유효성 검사
{
"name": "validate",
"arguments": {
"query": "query { users { id name } }"
}
}
쿼리 실행
{
"name": "execute",
"arguments": {
"query": "query { users { id name email } }"
}
}
문제 해결
일반적인 문제:
- 연결 오류:
GRAPHQL_ENDPOINT가 올바르고 접근 가능한지 확인합니다. - 인증 오류: 일부 GraphQL API는
APOLLO_API_KEY가 필요합니다. - 도구 실행 실패: 쿼리 문법을 확인하고 스키마 타입이 올바른지 검증합니다.