MCP 服务器

MCP Google Sheets Server

允许与 Google 表格交互的 Model Context Protocol (MCP) 服务器 Or, more literally: 模型上下文协议 (MCP) 服务器，允许与 Google 表格进行交互

shionhonda

开发者工具

访问服务器

README

MCP Google Sheets 服务器

本项目提供了一个模型上下文协议 (MCP) 服务器，允许与 Google Sheets 进行交互。

它公开了以下工具：

列出电子表格中的工作表（标签）。
从特定单元格范围读取数据。
将数据写入特定单元格范围。

它明确不提供用于管理 Google Drive 文件（列出、创建、删除文件夹/文件）的工具。访问仅限于电子表格内容。

前提条件

Python 3.11+
启用了 Google Sheets API 的 Google Cloud 项目
服务帐户密钥：
- 转到 Google Cloud Console 并创建一个新的服务帐户。
- 下载服务帐户密钥文件（JSON 格式）。
- 授予此服务帐户对您要访问的 Google Sheets 的“Editor”角色。

如何使用

克隆存储库。

git clone https://github.com/shionhonda/mcp-gsheet.git

设置 Google 凭据：
- 将 GOOGLE_APPLICATION_CREDENTIALS 环境变量设置为您下载的服务帐户 JSON 密钥文件的_绝对路径_。
```
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/service-account-key.json"
```
- 或者，您可以将密钥文件放置在 Google Cloud 客户端库识别的标准位置（不建议用于共享环境）。
安装依赖项：
```
uv venv
source .venv/bin/activate
```
运行服务器

要使用 MCP Inspector 开发服务器：
```
mcp dev server.py
```
要运行服务器：
```
mcp run server.py
```
服务器将启动并侦听通过标准输入/输出 (stdio) 的 MCP 请求。

Claude Desktop

将以下内容添加到您的 Claude Desktop 配置中：

{
  "mcpServers": {
    "gsheet": {
      "command": "/path/to/uv",
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/service-account-key.json"
      },
      "args": ["--directory", "/path/to/mcp-gsheet", "run", "server.py"]
    }
  }
}

提供的 MCP 工具

list_sheets(spreadsheet_id: str) -> list[str]: 列出指定电子表格中所有工作表的名称。
read_cells(spreadsheet_id: str, range_name: str) -> list[list[str]]: 从给定的范围读取数据（例如，'Sheet1!A1:B5'）。
write_cells(spreadsheet_id: str, range_name: str, values: list[list[str]]) -> str: 将提供的二维值列表写入指定的起始单元格/范围（例如，'Sheet1!C1'）。