Đây là một máy chủ MCP do Google Calendar API cung cấp. Máy chủ này cung cấp các công cụ để nhà phát triển xây dựng ứng dụng LLM trên Lịch.
Máy chủ Giao thức ngữ cảnh mô hình (MCP) đóng vai trò là một proxy giữa một dịch vụ bên ngoài cung cấp bối cảnh, dữ liệu hoặc các chức năng cho Mô hình ngôn ngữ lớn (LLM) hoặc ứng dụng AI. Máy chủ MCP kết nối các ứng dụng AI với các hệ thống bên ngoài như cơ sở dữ liệu và dịch vụ web, chuyển đổi các câu trả lời của chúng sang định dạng mà ứng dụng AI có thể hiểu được.
Thiết lập máy chủ
Bạn phải thiết lập máy chủ MCP của Lịch trước khi sử dụng. Để biết thêm thông tin về cách sử dụng máy chủ MCP từ xa của Google và Google Cloud, hãy xem bài viết Tổng quan về máy chủ MCP của Google Cloud.
Điểm cuối của máy chủ
Điểm cuối dịch vụ MCP là địa chỉ mạng và giao diện giao tiếp (thường là một URL) của máy chủ MCP mà một ứng dụng AI (Máy chủ lưu trữ cho ứng dụng MCP) sử dụng để thiết lập một kết nối an toàn, tiêu chuẩn. Đây là đầu mối liên hệ để LLM yêu cầu ngữ cảnh, gọi một công cụ hoặc truy cập vào một tài nguyên. Các điểm cuối MCP của Google có thể là toàn cầu hoặc theo khu vực.
API MCP Lịch có điểm cuối MCP chung sau đây:
- https://calendarmcp.googleapis.com/mcp/v1
Công cụ MCP
Công cụ MCP là một chức năng hoặc khả năng thực thi mà máy chủ MCP cung cấp cho một LLM hoặc ứng dụng AI để thực hiện một hành động trong thế giới thực.
Công cụ
Máy chủ MCP calendarmcp.googleapis.com có các công cụ sau:
| Công cụ MCP | |
|---|---|
list_events |
Trả về các sự kiện trên lịch đã cho khớp với tất cả các điều kiện ràng buộc được chỉ định. Bạn không nên chỉ định các hạn chế về thời gian, trừ phi người dùng yêu cầu. Đối với các cụm từ tìm kiếm dựa trên chủ đề hoặc từ khoá không giới hạn trên lịch chính, bạn phải sử dụng công cụ search_events. |
get_event |
Trả về một sự kiện duy nhất trên lịch đã cho. |
list_calendars |
Trả về những lịch mà người dùng này có quyền truy cập (danh sách lịch của họ). Sử dụng công cụ này để phân giải dữ liệu nhận dạng lịch (ví dụ: "lịch gia đình của tôi") thành calendar_id tương ứng (giá trị nhận dạng email)
|
suggest_time |
Đề xuất khoảng thời gian trên một hoặc nhiều lịch. |
create_event |
Tạo một sự kiện trên lịch đã cho. |
update_event |
Cập nhật một sự kiện trên lịch đã cho. |
delete_event |
Xoá một sự kiện trên lịch đã cho. |
respond_to_event |
Phản hồi một sự kiện trên lịch. |
search_events |
Tìm kiếm sự kiện trên lịch chính của người dùng bằng tính năng tìm kiếm ngữ nghĩa. |
Nhận thông số kỹ thuật của công cụ MCP
Để nhận thông số kỹ thuật của công cụ MCP cho tất cả công cụ trong một máy chủ MCP, hãy sử dụng phương thức tools/list. Ví dụ sau đây minh hoạ cách sử dụng curl để liệt kê tất cả các công cụ và thông số kỹ thuật hiện có trong máy chủ MCP.
| Yêu cầu 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 }' |