Google Forms MCP

🚀 Google 表單 MCP 服務器

本 MCP 服務器藉助 Google Forms API，提供創建、編輯和檢索表單響應等功能，可高效處理 Google 表單相關操作。

🚀 快速開始

📦 安裝指南

初始設置

克隆倉庫後，需安裝依賴項，可通過以下命令進入項目目錄：

cd google-forms-mcp

構建服務器

使用以下命令構建主要的 MCP 服務器：

# 構建主要的 MCP 服務器
npm run build

構建刷新令牌獲取腳本

運行以下命令構建刷新令牌獲取腳本：

# 構建刷新令牌獲取腳本
npm run build:token

開發環境中的執行

可選擇以下任意一種方式在開發環境中啟動服務器：

# 直接運行服務器
node build/index.js

# 或使用 npm 腳本
npm run start

⚙️ 設置方法

1. 在 Google Cloud Console 中創建項目並啟用 Google Forms API

   • 訪問 Google Cloud Console。
   • 從 APIs & Services > Library 搜索 "Google Forms API" 並啟用它。

2. 獲取 OAuth 2.0 客戶端 ID 和密鑰

   • 進入 APIs & Services > Credentials > 創建憑證 > OAuth 客戶端 ID。
   • 選擇應用程序類型為 "桌面應用"。

3. 設置環境變量並獲取刷新令牌

   export GOOGLE_CLIENT_ID="YOUR_CLIENT_ID"
   export GOOGLE_CLIENT_SECRET="YOUR_CLIENT_SECRET"
   cd google-forms-mcp
   npm run build
   node build/get-refresh-token.js
   

   ⚠️ 重要提示

   如果運行 get-refresh-token.js 時出現錯誤，請執行以下命令：

   cd google-forms-mcp
   npm run build:token
   node build/get-refresh-token.js
   

4. 複製顯示的刷新令牌

5. 更新 Claude 桌面應用程序的配置文件

   • 打開 ~/Library/Application Support/Claude/claude_desktop_config.json。
   • 在 mcpServers 部分的 google-forms-mcp 中添加環境變量：

   "google-forms-mcp": {
     "command": "node",
     "args": [
       "/path/to/your/google-forms-mcp/build/index.js" # 更新此路徑
     ],
     "env": {
       "GOOGLE_CLIENT_ID": "YOUR_CLIENT_ID",
       "GOOGLE_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
       "GOOGLE_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN"
     }
   }
   

6. 重啟 Claude 桌面應用程序

✨ 主要特性

此 MCP 服務器提供了一系列實用工具，可方便地操作 Google 表單：

1. create_form - 創建新的 Google 表單
2. add_text_question - 在表單中添加文本問題
3. add_multiple_choice_question - 在表單中添加多項選擇問題
4. get_form - 獲取表單詳細信息
5. get_form_responses - 獲取表單響應