mcpField
S
sheetport

sheetport

本地服务
github.com/CloudCorpRecords数据与分析02 周前更新
代码仓库

关于 sheetport

sheetport 是通过 Google Sheets API v4 管理电子表格、单元格值和基本工作表的 MCP 服务，为 MCP 客户端提供一组精简操作，并使用 Google OAuth 访问令牌。

主要功能

  1. 01读取和创建电子表格
  2. 02读取、更新、追加和清除单元格值
  3. 03批量更新单元格值
  4. 04添加、复制和重命名工作表

适用场景

  1. 01通过 MCP 客户端查看电子表格数据
  2. 02更新或追加单元格区域
  3. 03创建和整理基本工作表

MCP 相关

向 MCP 客户端提供电子表格和单元格值操作工具。可作为 stdio MCP 服务运行，并需提供 Google OAuth 访问令牌。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "cloudcorprecords-sheetport": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/sheetport"
      ]
    }
  }
}
启动命令npx -y @reneturcios/sheetport

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@reneturcios/sheetport0.1.0
ocighcr.io/cloudcorprecords/sheetport:0.1.0

工具

10

收录的工具列表 · 更新于 1 周前

参数类型必填说明
spreadsheet_idstring是要检索的电子表格唯一标识符。

详细介绍

sheetport

将 Google Sheets 电子表格和单元格值作为 MCP 工具，通过 Google Sheets API v4 进行交互。sheetport 是对 Google Sheets MCP 功能核心子集的全新实现，采用新名称：电子表格和值操作，以及基本工作表管理；代码全新编写，不复制品牌元素。

工具（核心子集，共 10 个）

get_spreadsheet、create_spreadsheet、get_values、update_values、 append_values、clear_values、batch_update_values、add_sheet、 copy_sheet、rename_sheet。

此子集不包含格式设置、图表、数据透视表、条件格式、开发者元数据、受保护范围、命名范围、通用电子表格 batchUpdate 透传以及 Drive 文件操作。

设置

设置 Google OAuth 访问令牌：

export GOOGLE_ACCESS_TOKEN=ya29....

可选：使用 SHEETS_API_URL 覆盖 API 基础 URL（默认值为 https://sheets.googleapis.com/v4）。未设置令牌时，每次工具调用都会失败，并提示缺少的变量。

CLI

npx @reneturcios/sheetport get_values '{"spreadsheet_id":"abc","range":"Sheet1!A1:B2"}'
npx @reneturcios/sheetport mcp        # stdio MCP server

每个工具名称都是一个子命令，接受一个 JSON 对象参数。

MCP 客户端配置

{
  "mcpServers": {
    "sheetport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/sheetport", "mcp"],
      "env": { "GOOGLE_ACCESS_TOKEN": "ya29...." }
    }
  }
}

Docker

docker run -i -e GOOGLE_ACCESS_TOKEN ghcr.io/cloudcorprecords/sheetport

开发

npm install
npm run build
npm test

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。