People API MCP 서버
모델 컨텍스트 프로토콜 (MCP) 서버는 대규모 언어 모델 (LLM) 또는 AI 애플리케이션에 컨텍스트, 데이터 또는 기능을 제공하는 외부 서비스 간의 프록시 역할을 합니다. MCP 서버는 AI 애플리케이션을 데이터베이스 및 웹 서비스와 같은 외부 시스템에 연결하여 응답을 AI 애플리케이션이 이해할 수 있는 형식으로 변환합니다.
서버 설정
사용하기 전에 People API MCP 서버를 구성해야 합니다. Google 및 Google Cloud 원격 MCP 서버 사용에 관한 자세한 내용은 Google Cloud MCP 서버 개요를 참고하세요.
서버 엔드포인트
MCP 서비스 엔드포인트는 AI 애플리케이션 (MCP 클라이언트의 호스트)이 보안 표준 연결을 설정하는 데 사용하는 MCP 서버의 네트워크 주소 및 통신 인터페이스 (일반적으로 URL)입니다. LLM이 컨텍스트를 요청하거나 도구를 호출하거나 리소스에 액세스하는 접점입니다. Google MCP 엔드포인트는 전역 또는 리전일 수 있습니다.
People API MCP 서버에는 다음과 같은 전역 MCP 엔드포인트가 있습니다.
- https://people.googleapis.com/mcp/v1
People API MCP 서버는 다음과 같은 MCP 도구 모음 엔드포인트를 제공합니다.
- https://people.googleapis.com/mcp/v1
MCP 도구
MCP 도구는 MCP 서버가 LLM 또는 AI 애플리케이션에 노출하여 실제 세계에서 작업을 실행하는 함수 또는 실행 가능한 기능입니다. 도구 모음은 특정 작업에 유용한 도구 그룹입니다. 도구 모음을 사용하면 에이전트가 사용할 수 있는 도구의 수가 줄어들기 때문에 에이전트의 성능을 개선할 수 있습니다.
도구 모음
people.googleapis.com MCP 서버에는 다음과 같은 도구 모음이 있습니다.
| MCP 도구 모음 | ||
|---|---|---|
| 엔드포인트 | 설명 | 도구 |
| /mcp/v1 | People API용 MCP 도구 | |
MCP 도구 사양 가져오기
MCP 서버의 모든 도구에 대한 MCP 도구 사양을 가져오려면 tools/list 메서드를 사용하세요. 다음 예시에서는 curl을 사용하여 MCP 서버 내에서 현재 사용할 수 있는 모든 도구와 사양을 나열하는 방법을 보여줍니다.
| curl 요청 |
|---|
curl --location 'https://people.googleapis.com/mcp/v1' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |