MCP Server Spreadsheet

🚀 Google 表格 MCP 服務器

本項目是一個 Model Context Protocol (MCP) 服務器實現，它能與 Google 表格集成，讓 AI 助手可檢索和修改電子表格數據。藉助此服務器，Claude 能直接與您的 Google 表格數據進行交互。

🚀 快速開始

此服務器可讓 Claude 直接與您的 Google 表格數據交互。以下是使用前的演示、特性、先決條件、安裝及認證設置等相關信息。

演示

✨ 主要特性

該服務器提供了以下工具來處理 Google 表格：

• get_sheets：檢索電子表格的所有工作表信息，包括名稱、維度和 ID
• get_sheet_values：從特定工作表中檢索值，可選範圍指定
• update_cells：更新特定範圍內單元格的值
• batch_update_cells：一次性跨不同工作表更新多個範圍
• add_sheet：在現有電子表格中添加新工作表，帶有自定義維度

📦 安裝指南

先決條件

• Node.js（v18 或更高版本）
• 啟用了 Google 表格 API 的 Google 雲項目
• Google 雲身份驗證憑據
• Claude Desktop（用於與 Claude 集成）

安裝步驟

1. 克隆此倉庫：

   git clone https://github.com/yourusername/mcp-server-spreadsheet.git
   cd mcp-server-spreadsheet
   

2. 安裝依賴項：

   pnpm install
   

認證設置

此服務器使用 Google 雲的應用默認憑據進行認證，以訪問 Google 表格。

1. 如果尚未安裝，請安裝 Google Cloud CLI
2. 登錄並授權對 Google 表格的訪問：

   gcloud auth application-default login --scopes=openid,https://www.googleapis.com/auth/userinfo.email,https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spreadsheets
   

⚠️ 重要提示

• 確保在 Google Cloud 項目中啟用了表格 API。
• 認證完成後，系統會生成必要的憑據文件。

📚 詳細文檔

開發

項目結構

• src/index.ts：主入口點
• src/tools/：各個 MCP 工具的實現
• src/utils/：實用函數和服務
• src/types/：TypeScript 類型定義

運行測試

pnpm test

環境變量

您可以在項目根目錄創建一個 .env 文件，添加以下變量：

# 可選：覆蓋 Google API 憑據路徑
GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json

# 可選：調試模式
DEBUG=true

故障排除

• 認證錯誤：確保設置了正確的憑據，並且 Google 表格 API 已在您的 Google Cloud 項目中啟用。
• 權限錯誤：確認您的 Google 賬戶或服務賬戶具有訪問您嘗試操作的表格的權限。
• 服務器連接問題：檢查 Claude Desktop 是否正確配置以啟動 MCP 服務器。

📄 許可證

本項目採用 MIT 許可證。

💪 貢獻

歡迎貢獻！請隨意提交 Pull Request。