MCP Reference: sheetsmcp.googleapis.com

Đây là một máy chủ MCP cung cấp các công cụ để tương tác với Google Trang tính.

Máy chủ Giao thức ngữ cảnh mô hình (MCP) đóng vai trò là một proxy giữa dịch vụ bên ngoài cung cấp ngữ 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. Các 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 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

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 sheetsmcp.googleapis.com có các công cụ sau:

Công cụ MCP
get_values Trả về một dải giá trị từ bảng tính. Tương ứng với spreadsheets.values.get trong REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get
get_spreadsheet Trả về nội dung bảng tính cho bảng tính đã cho. Trả về tiêu đề, tên trang tính, thuộc tính lưới và các siêu dữ liệu khác cho mã nhận dạng bảng tính đã cho. Cũng trả về dữ liệu lưới đầy đủ nếu được yêu cầu. Tương ứng với spreadsheets.get trong API REST: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get
update_spreadsheet

Áp dụng một hoặc nhiều nội dung cập nhật cho bảng tính.

Tương ứng với spreadsheets.batchUpdate trong REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate

Sau đây là danh sách các bản cập nhật có thể có:

  • updateSpreadsheetProperties: Cập nhật các thuộc tính của bảng tính.
  • updateSheetProperties: Cập nhật các thuộc tính của trang tính.
  • updateDimensionProperties: Cập nhật các thuộc tính của phương diện.
  • updateNamedRange: Cập nhật một dải ô được đặt tên.
  • repeatCell: Lặp lại một ô duy nhất trên một dải ô.
  • addNamedRange: Thêm một dải ô được đặt tên.
  • deleteNamedRange: Xoá một dải ô được đặt tên.
  • addSheet: Thêm một trang tính.
  • deleteSheet: Xoá một trang tính.
  • autoFill: Tự động điền thêm dữ liệu dựa trên dữ liệu hiện có.
  • cutPaste: Cắt dữ liệu từ một vùng và dán vào một vùng khác.
  • copyPaste: Sao chép dữ liệu từ một vùng và dán vào một vùng khác.
  • mergeCells: Hợp nhất các ô với nhau.
  • unmergeCells: Huỷ hợp nhất các ô đã hợp nhất.
  • updateBorders: Cập nhật đường viền trong một dải ô.
  • updateCells: Cập nhật nhiều ô cùng một lúc.
  • addFilterView: Thêm một chế độ xem bộ lọc.
  • appendCells: Thêm các ô sau hàng cuối cùng có dữ liệu trong một trang tính.
  • clearBasicFilter: Xoá bộ lọc cơ bản trên một trang tính.
  • deleteDimension: Xoá hàng hoặc cột trong một trang tính.
  • deleteEmbeddedObject: Xoá một đối tượng được nhúng (ví dụ: biểu đồ, hình ảnh) trong một trang tính.
  • deleteFilterView: Xoá một chế độ xem bộ lọc khỏi trang tính.
  • duplicateFilterView: Sao chép một chế độ xem bộ lọc.
  • duplicateSheet: Sao chép một trang tính.
  • findReplace: Tìm và thay thế các trường hợp xuất hiện của một số văn bản bằng văn bản khác.
  • insertDimension: Chèn hàng hoặc cột mới vào trang tính.
  • insertRange: Chèn các ô mới vào một trang tính, di chuyển các ô hiện có.
  • moveDimension: Di chuyển các hàng hoặc cột đến một vị trí khác trong trang tính.
  • updateEmbeddedObjectPosition: Cập nhật vị trí của một đối tượng được nhúng (ví dụ: biểu đồ, hình ảnh).
  • pasteData: Dán dữ liệu (HTML hoặc được phân tách bằng dấu phân cách) vào một trang tính.
  • textToColumns: Chuyển đổi một cột văn bản thành nhiều cột văn bản.
  • updateFilterView: Cập nhật các thuộc tính của một chế độ xem bộ lọc.
  • deleteRange: Xoá một dải ô khỏi trang tính, di chuyển các ô còn lại.
  • appendDimension: Nối các phương diện vào cuối trang tính.
  • addConditionalFormatRule: Thêm một quy tắc định dạng có điều kiện mới.
  • updateConditionalFormatRule: Cập nhật một quy tắc định dạng có điều kiện hiện có.
  • deleteConditionalFormatRule: Xoá một quy tắc định dạng có điều kiện hiện có.
  • sortRange: Sắp xếp dữ liệu trong một dải ô.
  • setDataValidation: Đặt quy trình xác thực dữ liệu cho một hoặc nhiều ô.
  • setBasicFilter: Đặt bộ lọc cơ bản trên một trang tính.
  • addProtectedRange: Thêm một dải ô được bảo vệ.
  • updateProtectedRange: Cập nhật một dải ô được bảo vệ.
  • deleteProtectedRange: Xoá một dải ô được bảo vệ.
  • autoResizeDimensions: Tự động đổi kích thước một hoặc nhiều phương diện dựa trên nội dung của các ô trong phương diện đó.
  • addChart: Thêm biểu đồ.
  • updateChartSpec: Cập nhật các thông số kỹ thuật của biểu đồ.
  • updateBanding: Cập nhật một dải ô có đường viền
  • addBanding: Thêm một dải ô mới
  • deleteBanding: Xoá một dải có đường viền
  • createDeveloperMetadata: Tạo siêu dữ liệu nhà phát triển mới
  • updateDeveloperMetadata: Cập nhật một mục siêu dữ liệu nhà phát triển hiện có
  • deleteDeveloperMetadata: Xoá siêu dữ liệu của nhà phát triển
  • randomizeRange: Trộn ngẫu nhiên thứ tự của các hàng trong một dải ô.
  • addDimensionGroup: Tạo một nhóm trong phạm vi đã chỉ định.
  • deleteDimensionGroup: Xoá một nhóm trong phạm vi đã chỉ định.
  • updateDimensionGroup: Cập nhật trạng thái của nhóm được chỉ định.
  • trimWhitespace: Cắt bỏ khoảng trắng trong các ô (chẳng hạn như dấu cách, dấu tab hoặc dòng mới).
  • deleteDuplicates: Xoá các hàng chứa giá trị trùng lặp trong các cột được chỉ định của một dải ô.
  • updateEmbeddedObjectBorder: Cập nhật đường viền của một đối tượng được nhúng.
  • addSlicer: Thêm bộ cắt.
  • updateSlicerSpec: Cập nhật các thông số kỹ thuật của bộ cắt.
  • addDataSource: Thêm một nguồn dữ liệu.
  • updateDataSource: Cập nhật một nguồn dữ liệu.
  • deleteDataSource: Xoá một nguồn dữ liệu.
  • refreshDataSource: Làm mới một hoặc nhiều nguồn dữ liệu và các đối tượng dbobject được liên kết.
  • cancelDataSourceRefresh: Huỷ làm mới một hoặc nhiều nguồn dữ liệu và dbobject được liên kết.
  • addTable: Thêm bảng.
  • updateTable: Cập nhật một bảng.
  • deleteTable: Yêu cầu xoá một bảng.
update_values Đặt các giá trị trong một dải ô của bảng tính. Tương ứng với spreadsheets.values.update trong REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
update_formulas Đặt công thức trong một dải ô của bảng tính. Tương ứng với spreadsheets.values.update trong REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
insert_dimension Chèn hàng hoặc cột vào một trang tính tại một chỉ mục cụ thể. Tương ứng với InsertDimensionRequest trong API REST spreadsheets.batchUpdate: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request

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á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://sheetsmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'