Máy chủ Giao thức ngữ cảnh mô hình (MCP) hoạt động như một proxy giữa một dịch vụ bên ngoài cung cấp ngữ cảnh, dữ liệu hoặc các tính 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, dịch các phản hồi của chúng sang định dạng mà ứng dụng AI có thể hiểu được.
Công cụ MCP
Một công cụ MCP là một hàm hoặc tính năng có thể thực thi mà máy chủ MCP cung cấp cho LLM hoặc ứng dụng AI để thực hiện một hành động trong thế giới thực.
Máy chủ MCP gmailmcp.googleapis.com có các công cụ sau:
| Công cụ MCP | |
|---|---|
| create_draft |
Tạo một email nháp mới trong tài khoản Gmail của người dùng đã xác thực. Công cụ này nhận địa chỉ người nhận, tiêu đề và nội dung làm dữ liệu đầu vào. Công cụ này trả về mã nhận dạng của email nháp đã tạo trong Gmail. |
| list_drafts |
Liệt kê các email nháp từ tài khoản Gmail của người dùng đã xác thực. Công cụ này có thể lọc email nháp dựa trên một chuỗi truy vấn và hỗ trợ phân trang. Công cụ này trả về danh sách email nháp, bao gồm cả mã nhận dạng và tiêu đề của các email đó. |
| get_thread | Truy xuất một chuỗi email cụ thể từ tài khoản Gmail của người dùng đã xác thực, bao gồm cả danh sách các email trong chuỗi đó. |
| search_threads |
Liệt kê các chuỗi email từ tài khoản Gmail của người dùng đã xác thực. Công cụ này có thể lọc chuỗi dựa trên một chuỗi truy vấn và hỗ trợ phân trang. Công cụ này trả về danh sách các chuỗi, bao gồm cả mã nhận dạng và các email liên quan. Mỗi email liên quan chứa thông tin chi tiết như trích đoạn nội dung thư, tiêu đề, người gửi, người nhận, v.v. Xin lưu ý rằng công cụ này không trả về toàn bộ nội dung thư; hãy sử dụng công cụ "get_thread" với mã nhận dạng chuỗi để tìm nạp toàn bộ nội dung thư nếu cần. |
| label_thread |
Thêm nhãn vào toàn bộ chuỗi trong tài khoản Gmail của người dùng đã xác thực. Thao tác này ảnh hưởng đến tất cả các email hiện có trong chuỗi và mọi email trong tương lai được thêm vào chuỗi đó. Nếu bạn không chắc chắn về mã nhận dạng chuỗi, hãy sử dụng công cụ Nếu bạn không chắc chắn về mã nhận dạng nhãn của người dùng, hãy sử dụng công cụ |
| unlabel_thread |
Xoá nhãn khỏi toàn bộ chuỗi trong tài khoản Gmail của người dùng đã xác thực. Nếu bạn không chắc chắn về mã nhận dạng chuỗi, hãy sử dụng công cụ search_threads trước. Nếu bạn không chắc chắn về mã nhận dạng nhãn của người dùng, hãy sử dụng công cụ list_labels trước.
|
| list_labels |
Liệt kê tất cả các nhãn do người dùng xác định có trong tài khoản Gmail của người dùng đã xác thực. Sử dụng công cụ này để khám phá id của nhãn người dùng trước khi gọi label_thread, unlabel_thread, label_message hoặc unlabel_message. Công cụ này không trả về nhãn hệ thống nhưng có thể sử dụng với các mã nhận dạng đã biết: "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD", "IMPORTANT", "CHAT", "DRAFT", "SENT".
|
| label_message |
Thêm một hoặc nhiều nhãn vào một email cụ thể trong tài khoản Gmail của người dùng đã xác thực. Để tìm mã nhận dạng email, hãy sử dụng các công cụ như |
| unlabel_message |
Xoá một hoặc nhiều nhãn khỏi một email cụ thể trong tài khoản Gmail của người dùng đã xác thực. Để tìm mã nhận dạng email, hãy sử dụng các công cụ như search_threads hoặc get_thread. Nếu bạn không chắc chắn về mã nhận dạng nhãn của người dùng, hãy sử dụng công cụ list_labels trước để khám phá các nhãn hiện có và mã nhận dạng của các nhãn đó.
|
| create_label | Tạo một nhãn mới trong tài khoản Gmail của người dùng đã xác thực. |
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ác công cụ trong 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://gmailmcp.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |