Spreadsheet MCP Server

电子表格MCP服务器

此项目包括：Google Spreadsheet访问数据Model Context Protocol (MCP) 服务器。LLM将条目添加到文档注册表。

机能

• 获取电子表格的基本信息（例如，工作表列表）
• 获取特定工作表的数据并以标记形式进行整形
• MCP与客户端（例如，桌面）集成

安装

# リポジトリのクローン
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脚本Web应用程序のURL
• GAS_API_KEY：Google Apps脚本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

Claude for Desktop与集成

Claude for Desktop的配置文件（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
• 窗户： %AppData%\\Claude\\claude_desktop_config.json

MCP Inspector测试

npx @modelcontextprotocol/inspector node build/index.js

提供的工具

获取电子表格

获取电子表格的基本信息和包含的工作表列表。

输入参数:

• url：在电子表格中URL

出力:

• 电子表格名称ID、工作表列表（包括行数和列数）

getSheetData

获取电子表格特定工作表的数据。

输入参数:

• url：在电子表格中URL
• sheetName：要检索的工作表名称

出力:

• 图纸数据（下标表格形式）

开発

项目结构

src/
├── index.ts           # エントリポイント
├── server.ts          # MCPサーバー設定
├── config.ts          # 環境変数と設定管理
├── tools/             # ツール実装
│   ├── getSpreadsheet.ts
│   ├── getSheetData.ts
│   └── index.ts
├── api/               # API処理
│   ├── README.md      # API仕様
│   ├── spreadsheet.ts
│   └── types.ts
└── utils/             # ユーティリティ
    └── format.ts

测试

# 単体テスト実行
npm test

# ウォッチモードでテスト
npm run test:watch

Google Apps Script关于与的合作

此服务器在实际使用时Google Apps Script的，之Web App进行动态观察时的轴心点

1. 谷歌应用脚本で网页应用创建
2. Web在应用程序端访问电子表格API实施（api/README.md参照）
3. API设置关键帧和环境变量GAS_WEB_APP_URL打开GAS_API_KEY联合

通过这种方法Google避免验证流并维护电子表格的安全性。

如果未设置环境变量，则在拖车模式下运行，并返回用于测试的数据。

许可证

麻省理工学院