MCP Gsheet

🚀 MCP 谷歌表格服務器

本項目提供了一個模型上下文協議（MCP）服務器，可實現與谷歌表格的交互。它能夠列出電子表格中的工作表，讀取特定單元格範圍的數據，以及向特定單元格範圍寫入數據。不過，該項目不提供管理 Google Drive 文件（如列出、創建、刪除文件/文件夾）的工具，訪問範圍僅限於電子表格內容。

✨ 主要特性

• 可列出電子表格中的工作表（標籤頁）。
• 支持從特定的單元格範圍讀取數據。
• 能夠向特定的單元格範圍寫入數據。

📦 安裝指南

先決條件

1. Python 3.11+
2. 啟用 Google Sheets API 的 Google Cloud 項目
3. 服務賬戶密鑰：
   • 前往 Google Cloud Console 創建一個新的服務賬戶。
   • 下載服務賬戶密鑰文件（JSON 格式）。
   • 向該服務賬戶授予訪問目標電子表格的“編輯器”角色。

安裝步驟

1. 克隆倉庫

   git clone https://github.com/shionhonda/mcp-gsheet.git
   

2. 設置 Google 憑據
   • 設置 GOOGLE_APPLICATION_CREDENTIALS 環境變量為下載的服務賬戶密鑰文件的絕對路徑。

   export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/service-account-key.json"
   

   • 或者，將密鑰文件放置在 Google Cloud 客戶端庫識別的標準位置（不推薦用於共享環境）。
3. 安裝依賴項

   uv venv
   source .venv/bin/activate
   

💻 使用示例

運行服務器

使用 MCP 檢查器開發服務器：

mcp dev server.py

運行服務器：

mcp run server.py

服務器將啟動並偵聽標準輸入/輸出（stdio）上的 MCP 請求。

Claude Desktop 配置

在你的 Claude Desktop 配置中添加以下內容：

{
  "mcpServers": {
    "gsheet": {
      "command": "/path/to/uv",
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/service-account-key.json"
      },
      "args": ["--directory", "/path/to/mcp-gsheet", "run", "server.py"]
    }
  }
}

📚 詳細文檔

MCP 工具提供的功能

• list_sheets(spreadsheet_id: str) -> list[str]：列出指定電子表格中的所有工作表名稱。
• read_cells(spreadsheet_id: str, range_name: str) -> list[list[str]]：從給定的範圍（例如 'Sheet1!A1:B5'）讀取數據。
• write_cells(spreadsheet_id: str, range_name: str, values: list[list[str]]) -> str：將提供的二維字符串列表寫入指定的起始單元格/範圍（例如 'Sheet1!C1'）。