MCP Reference: sheetsmcp.googleapis.com

这是一个 MCP 服务器,提供用于与 Google 表格交互的工具。

Model Context Protocol (MCP) 服务器充当外部服务(为大语言模型 [LLM] 或 AI 应用提供上下文、数据或功能)与 LLM 或 AI 应用之间的代理。MCP 服务器将 AI 应用连接到数据库和 Web 服务等外部系统,并将这些系统的响应转换为 AI 应用可理解的格式。

MCP 工具

MCP 工具是 MCP 服务器向 LLM 或 AI 应用公开的函数或可执行功能,用于在现实世界中执行操作。

工具

sheetsmcp.googleapis.com MCP 服务器具有以下工具:

MCP 工具
get_values 返回电子表格中的某个值范围。对应于 REST API 中的 spreadsheets.values.get:https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get
get_spreadsheet 返回指定电子表格的内容。返回指定电子表格 ID 的标题、工作表名称、网格属性和其他元数据。如果请求,还会返回完整网格数据。对应于 REST API 中的 spreadsheets.get:https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get
update_spreadsheet

对电子表格应用一项或多项更新。

对应于 REST API 中的 spreadsheets.batchUpdate:https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate

可能的更新列表如下:

  • updateSpreadsheetProperties:更新电子表格的属性。
  • updateSheetProperties:更新工作表的属性。
  • updateDimensionProperties:更新维度的属性。
  • updateNamedRange:更新命名的范围。
  • repeatCell:在某个范围内重复单个单元格。
  • addNamedRange:添加命名的范围。
  • deleteNamedRange:删除命名的范围。
  • addSheet:添加工作表。
  • deleteSheet:删除工作表。
  • autoFill:根据现有数据自动填充更多数据。
  • cutPaste:剪切某个区域的数据并将其粘贴到另一个区域。
  • copyPaste:将数据从一个区域复制到另一个区域。
  • mergeCells:将单元格合并在一起。
  • unmergeCells:取消合并已合并的单元格。
  • updateBorders:更新某个单元格范围内的边框。
  • updateCells:一次更新多个单元格。
  • addFilterView:添加过滤视图。
  • appendCells:将单元格附加到工作表中包含数据的最后一行的后面。
  • clearBasicFilter:清除工作表上的基本过滤条件。
  • deleteDimension:删除工作表中的行或列。
  • deleteEmbeddedObject:删除工作表中的嵌入式对象(例如图表、图片)。
  • deleteFilterView:从工作表中删除过滤视图。
  • duplicateFilterView:复制过滤视图。
  • duplicateSheet:复制工作表。
  • findReplace:查找并替换某些文本。
  • insertDimension:在工作表中插入新行或新列。
  • insertRange:在工作表中插入新单元格,并移动现有单元格。
  • moveDimension:将行或列移到工作表中的其他位置。
  • updateEmbeddedObjectPosition:更新嵌入式对象(例如图表、图片)的位置。
  • pasteData:将数据(HTML 或分隔数据)粘贴到工作表中。
  • textToColumns:将文本列转换为多个文本列。
  • updateFilterView:更新过滤视图的属性。
  • deleteRange:从工作表中删除一定范围的单元格,并移动剩余的单元格。
  • appendDimension:将维度附加到工作表的末尾。
  • addConditionalFormatRule:添加新的条件格式规则。
  • updateConditionalFormatRule:更新现有的条件格式规则。
  • deleteConditionalFormatRule:删除现有的条件格式规则。
  • sortRange:对某个范围中的数据进行排序。
  • setDataValidation:为一个或多个单元格设置数据验证。
  • setBasicFilter:在工作表上设置基本过滤条件。
  • addProtectedRange:添加受保护的范围。
  • updateProtectedRange:更新受保护的范围。
  • deleteProtectedRange:删除受保护的范围。
  • autoResizeDimensions:根据相应维度中单元格的内容自动调整一个或多个维度的大小。
  • addChart:添加图表。
  • updateChartSpec:更新图表的规范。
  • updateBanding:更新分段范围
  • addBanding:添加新的分级范围
  • deleteBanding:移除分段范围
  • createDeveloperMetadata:创建新的开发者元数据
  • updateDeveloperMetadata:更新现有的开发者元数据条目
  • deleteDeveloperMetadata:删除开发者元数据
  • randomizeRange:随机化某个范围内各行的顺序。
  • addDimensionGroup:在指定范围内创建群组。
  • deleteDimensionGroup:删除指定范围内的群组。
  • updateDimensionGroup:更新指定群组的状态。
  • trimWhitespace:去除单元格中的空格(例如空格、制表符或换行符)。
  • deleteDuplicates:移除单元格范围的指定列中包含重复值的行。
  • updateEmbeddedObjectBorder:更新嵌入式对象的边框。
  • addSlicer:添加切片器。
  • updateSlicerSpec:更新切片器的规范。
  • addDataSource:添加数据源。
  • updateDataSource:更新数据源。
  • deleteDataSource:删除数据源。
  • refreshDataSource:刷新一个或多个数据源及关联的数据库对象。
  • cancelDataSourceRefresh:取消一个或多个数据源及关联的 dbobject 的刷新。
  • addTable:添加表格。
  • updateTable:更新表格。
  • deleteTable:用于删除表的请求。
update_values 设置电子表格中某个范围内的值。对应于 REST API 中的 spreadsheets.values.update:https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
update_formulas 在电子表格的某个范围内设置公式。对应于 REST API 中的 spreadsheets.values.update:https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
insert_dimension 在工作表的特定索引处插入行或列。对应于 spreadsheets.batchUpdate REST API 中的 InsertDimensionRequest:https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request

获取 MCP 工具规范

如需获取 MCP 服务器中所有工具的 MCP 工具规范,请使用 tools/list 方法。下面的示例演示了如何使用 curl 列出 MCP 服务器中当前可用的所有工具及其规范。

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
}'