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 許可證。