Spreadsheet MCP Server
2025.04.03
1
TypeScript电子表格处理数据集成开发效率
Spreadsheet MCP Server 是一个用于访问 Google Spreadsheet 数据的 Model Context Protocol (MCP) 服务器，旨在让 LLM 能够直接利用电子表格信息。它提供了获取电子表格基本信息、特定工作表数据的功能，并支持与 MCP 客户端（如 Claude for Desktop）集成。
View on GitHub
Overview
基本能力
产品定位
Spreadsheet MCP Server 是一个中间件，用于桥接 Google Spreadsheet 和 LLM（大型语言模型），使得 LLM 能够直接访问和处理电子表格数据。
核心功能
- 获取电子表格的基本信息（如工作表列表）
- 获取特定工作表的数据并以 Markdown 格式进行格式化
- 与 MCP 客户端（如 Claude for Desktop）集成
适用场景
- LLM 需要访问和处理电子表格数据的场景
- 自动化数据处理和分析工作流
- 电子表格数据与 AI 模型的集成应用
工具列表
- getSpreadsheet
- 功能：获取电子表格的基本信息和包含的工作表列表
- 输入参数：
url（电子表格的 URL） -
输出：电子表格名称、ID、工作表列表（包含行数和列数）
-
getSheetData
- 功能：获取电子表格中特定工作表的数据
- 输入参数：
url（电子表格的 URL）和sheetName（工作表名称） - 输出：工作表数据（以 Markdown 表格格式）
常见问题解答
- 如果没有设置环境变量，服务器将在模拟模式下运行，不会访问实际的 Google 电子表格。
- 需要与 Google Apps Script 的 Web App 集成才能访问实际的电子表格数据。
使用教程
使用依赖
- 确保已安装 Node.js 和 npm
- 克隆项目仓库：
bash git clone https://github.com/your-username/spreadsheet-mcp-server.git cd spreadsheet-mcp-server
安装教程
- 安装依赖：
bash npm install - 配置环境变量：
bash cp .env.example .env然后编辑.env文件，设置GAS_WEB_APP_URL和GAS_API_KEY - 构建项目：
bash npm run build
调试方式
- 启动服务器：
bash npm start - 使用 MCP Inspector 进行测试：
bash npx @modelcontextprotocol/inspector node build/index.js - 与 Claude for Desktop 集成：
编辑 Claude for Desktop 的配置文件
claude_desktop_config.json，添加服务器配置。