Google 表格 MCP 服务器

这个项目是一个用于访问 Google Spreadsheet 数据的 Model Context Protocol (MCP) 服务器。它允许 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 App 的 URL 地址
• GAS_API_KEY: Google Apps Script Web App 的访问用 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 集成

在 Desktop Claude 的配置文件 (claude_desktop_config.json) 中添加以下内容：

{
  "mcpServers": {
    "spreadsheet": {
      "command": "node",
      "args": ["<absolute-path-to-project>/build/index.js"]
    }
  }
}

若需设置环境变量，可添加 env 字段如下：

{
  "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

检查方式

npm test

许可证

MIT