🚀 Google 表格 MCP 服务器
本项目搭建了一个基于 Model Context Protocol (MCP) 的服务器，用于访问 Google 表格数据。借助该服务器，大语言模型（LLM）可直接利用表格信息，为数据处理和应用提供了便利。
🚀 快速开始
此项目是一个通过 Model Context Protocol (MCP) 访问 Google 表格数据的服务器，使 LLM 直接利用表格信息成为可能。你可以按照以下步骤进行操作：
- 安装项目依赖。
- 配置环境变量。
- 启动服务器并进行测试。
✨ 主要特性
- 表格信息获取：能够获取表格的基本信息，如工作表列表等。
- 数据整理输出：可获取特定工作表的数据，并将其整理为 Markdown 格式。
- 客户端集成：支持与 MCP 客户端（如 Desktop Claude 等）集成。
📦 安装指南
你可以按照以下步骤安装本项目：
# 克隆仓库
git clone https://github.com/your-username/spreadsheet-mcp-server.git
cd spreadsheet-mcp-server
# 安装依赖
npm install
# 配置环境变量
cp .env.example .env
# 编辑 .env 文件设置 GAS_WEB_APP_URL 和 GAS_API_KEY
# 构建
npm run build
环境变量配置
服务器运行所需的环境变量如下：
GAS_WEB_APP_URL：Google Apps Script Web 应用的 URL。GAS_API_KEY：访问 Google Apps Script Web 应用的 API 密钥。
这些变量可在 .env 文件中设置：
GAS_WEB_APP_URL=https://script.google.com/macros/s/your-deployment-id/exec
GAS_API_KEY=your-api-key
若未配置环境变量，服务器将处于模拟模式，无法访问实际 Google 表格。
💻 使用示例
独立运行
npm start
与 Desktop Claude 集成
在 claude_desktop_config.json 配置文件中添加以下内容：
{
"mcpServers": {
"spreadsheet": {
"command": "node",
"args": ["<绝对路径到项目>/build/index.js"]
}
}
}
通过 env 字段配置环境变量：
{
"mcpServers": {
"spreadsheet": {
"command": "node",
"args": ["<绝对路径到项目>/build/index.js"],
"env": {
"GAS_WEB_APP_URL": "https://script.google.com/macros/s/your-deployment-id/exec",
"GAS_API_KEY": "your-api-key"
}
}
}
}
配置文件位置：
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%AppData%\\Claude\\claude_desktop_config.json
MCP Inspector 测试
npx @modelcontextprotocol/inspector node build/index.js
📚 详细文档
提供的工具
getSpreadsheet
获取表格的基本信息，包括工作表列表。
getSheetData
获取特定工作表的数据，并以 Markdown 格式返回。
项目结构
api/README.md：描述 Web 应用 API 的实现细节。- 其他文件和文件夹：如
src,public等，用于服务器的构建和运行。
📄 许可证
本项目采用 MIT 许可证。