이것은 Google Calendar API에서 제공하는 MCP 서버입니다. 이 서버는 개발자가 Calendar를 기반으로 LLM 애플리케이션을 빌드할 수 있는 도구를 제공합니다.
모델 컨텍스트 프로토콜 (MCP) 서버는 대규모 언어 모델 (LLM) 또는 AI 애플리케이션에 컨텍스트, 데이터 또는 기능을 제공하는 외부 서비스 간의 프록시 역할을 합니다. MCP 서버는 AI 애플리케이션을 데이터베이스 및 웹 서비스와 같은 외부 시스템에 연결하여 응답을 AI 애플리케이션이 이해할 수 있는 형식으로 변환합니다.
서버 설정
사용하기 전에 Calendar MCP 서버를 구성해야 합니다. Google 및 Google Cloud 원격 MCP 서버 사용에 관한 자세한 내용은 Google Cloud MCP 서버 개요를 참고하세요.
서버 엔드포인트
MCP 서비스 엔드포인트는 AI 애플리케이션 (MCP 클라이언트의 호스트)이 안전하고 표준화된 연결을 설정하는 데 사용하는 MCP 서버의 네트워크 주소 및 통신 인터페이스 (일반적으로 URL)입니다. LLM이 컨텍스트를 요청하거나, 도구를 호출하거나, 리소스에 액세스하기 위한 연락 지점입니다. Google MCP 엔드포인트는 전역 또는 리전일 수 있습니다.
Calendar MCP API에는 다음과 같은 전역 MCP 엔드포인트가 있습니다.
- https://calendarmcp.googleapis.com/mcp/v1
MCP 도구
MCP 도구는 MCP 서버가 LLM 또는 AI 애플리케이션에 노출하여 실제 세계에서 작업을 실행하는 함수 또는 실행 가능한 기능입니다.
도구
calendarmcp.googleapis.com MCP 서버에는 다음과 같은 도구가 있습니다.
| MCP 도구 | |
|---|---|
list_events |
지정된 모든 제약조건과 일치하는 지정된 캘린더의 일정을 반환합니다. 사용자가 요청하지 않는 한 시간 제약조건을 지정해서는 안 됩니다. 기본 캘린더에서 키워드 또는 주제 기반의 개방형 검색을 하려면 대신 search_events 도구를 사용해야 합니다. |
get_event |
지정된 캘린더의 단일 일정을 반환합니다. |
list_calendars |
이 사용자가 액세스할 수 있는 캘린더 (캘린더 목록)를 반환합니다. 이 도구를 사용하여 캘린더 식별 데이터 (예: '가족 캘린더')를 해당 calendar_id (이메일 식별자)로 확인합니다.
|
suggest_time |
하나 이상의 캘린더에서 시간대를 제안합니다. |
create_event |
지정된 캘린더에 일정을 만듭니다. |
update_event |
지정된 캘린더의 일정을 업데이트합니다. |
delete_event |
지정된 캘린더의 일정을 삭제합니다. |
respond_to_event |
캘린더의 일정에 응답합니다. |
search_events |
의미론적 검색을 사용하여 사용자의 기본 캘린더에서 일정을 검색합니다. |
MCP 도구 사양 가져오기
MCP 서버의 모든 도구에 대한 MCP 도구 사양을 가져오려면 tools/list 메서드를 사용하세요. 다음 예시에서는 curl을 사용하여 MCP 서버 내에서 현재 사용할 수 있는 모든 도구와 사양을 나열하는 방법을 보여줍니다.
| curl 요청 |
|---|
curl --location 'https://calendarmcp.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 }' |