Spreadsheet MCP Server

🚀 Google 表格 MCP 服务器

本项目搭建了一个服务器，借助 Model Context Protocol (MCP) 来访问 Google 表格数据，让大语言模型（LLM）能够直接利用表格信息。

🚀 快速开始

此服务器可助力 LLM 直接利用 Google 表格信息。下面为你详细介绍操作步骤。

✨ 主要特性

• 表格信息获取：可获取表格的基本信息，如工作表列表等。
• 数据整理：能获取特定工作表的数据，并将其整理为 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

环境变量配置

服务器运行所需的环境变量如下：

这些变量可在 .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

高级用法

# 获取特定工作表的数据，并以 Markdown 格式返回
getSheetData

📚 详细文档

项目结构

• api/README.md: 描述 Web 应用 API 的实现细节。
• 其他文件和文件夹：如 src, public 等，用于服务器的构建和运行。

📄 许可证

本项目采用 MIT 许可证。