Spreadsheet MCP Server

基本能力

产品定位

Spreadsheet MCP Server 是一个中间件，旨在桥接大型语言模型（LLM）与Google Spreadsheet之间的数据交互，提供高效的数据访问和格式化能力。

核心功能

• 获取电子表格基本信息：包括工作表列表等。
• 获取特定工作表数据：并以Markdown格式进行格式化。
• 与MCP客户端集成：如Claude for Desktop等。

适用场景

• 数据分析自动化：自动从电子表格中提取和分析数据。
• 报告生成：将电子表格数据转换为易于阅读的格式。
• LLM增强：为LLM提供实时电子表格数据支持。

工具列表

• getSpreadsheet：获取电子表格的基本信息和包含的工作表列表。
• 输入参数：url（电子表格的URL）。
• 输出：电子表格名称、ID、工作表列表（包括行数和列数）。
• getSheetData：获取电子表格中特定工作表的数据。
• 输入参数：url（电子表格的URL）、sheetName（工作表名称）。
• 输出：工作表数据（Markdown表格格式）。

常见问题解答

• 环境变量未设置：服务器将在模拟模式下运行，不访问实际的Google Spreadsheet。
• Google Apps Script集成：需要创建Web App并设置API密钥以实现安全访问。

使用教程

使用依赖

确保已安装Node.js和npm。

安装教程

# 克隆仓库
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

调试方式

# 启动服务器
npm start

# 使用MCP Inspector测试
npx @modelcontextprotocol/inspector node build/index.js

与Claude for Desktop集成

在Claude for Desktop的配置文件中添加以下内容：

{
  "mcpServers": {
    "spreadsheet": {
      "command": "node",
      "args": ["<absolute-path-to-project>/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

许可证

该项目遵循 MIT 开源许可条款。