Google Form MCP Server

一個集成Google Forms API和CamelAIOrg代理的自然語言表單管理系統

教育與學習工具開發者工具 #智能表單 #自然語言處理 #API集成 #自動化工具 .Python

評分 : 2.5分

下載量 : 6.3K

更新時間 : 2025-04-28

打開站點

什麼是Google Forms MCP 服務器？

Google Forms MCP 服務器是一個基於Flask構建的系統，允許您通過自然語言指令輕鬆創建、修改和獲取Google Forms。它通過集成Google Forms API和CamelAIOrg Agents來實現這一目標。

如何使用Google Forms MCP 服務器？

只需輸入自然語言請求（如“創建一個反饋表”），系統會自動處理並生成相應的Google Form。

適用場景

適合需要快速創建調查問卷、反饋表或其他表單的個人或團隊。

主要功能

創建Google Forms

支持通過自然語言指令創建新的Google Forms。

添加多種問題類型

可以添加文本、段落、多項選擇、複選框等多種問題類型。

獲取表單響應

可以直接從Google Forms API中檢索表單的提交數據。

可視化請求流程

提供動態動畫展示請求在不同組件之間的流轉過程。

優勢

無需編程即可創建複雜的Google Forms。

支持多語言指令解析，易於上手。

提供全面的API接口，便於二次開發。

具有暗黑主題UI，用戶體驗佳。

侷限性

需要Google Cloud賬戶及API密鑰。

對於非常複雜的需求可能需要手動調整設置。

依賴於網絡連接，離線操作不可用。

如何使用

安裝Docker和Docker Compose

確保您的計算機已安裝最新版本的Docker和Docker Compose。

克隆代碼倉庫

使用Git克隆本項目的源代碼。

配置Google Forms API

啟用Google Forms API並生成OAuth2憑證。

啟動服務

運行Docker Compose命令啟動MCP服務器和CamelAIOrg Agents。

使用案例

創建一個反饋表

用戶可以通過簡單的自然語言指令創建一個反饋表。

添加多項選擇題

向現有表單中添加多項選擇題。

常見問題

如何獲取Google Forms API的OAuth2憑證？

是否支持自定義問題類型？

如何停止服務？

🚀 谷歌表單與CamelAIOrg集成項目

本項目展示瞭如何藉助Model Context Protocol（MCP）協議，將谷歌表單與CamelAIOrg代理服務進行集成。用戶能夠通過自然語言發起創建表單的請求，系統內部則利用MCP協議完成交互，為表單創建提供了便捷、高效的方式。

🚀 快速開始

安裝與運行

使用Docker運行

docker-compose up --build

此命令將啟動MCP服務器（監聽5000端口）和代理服務（監聽5001端口）。

環境配置

創建項目根目錄下的.env文件：

# 谷歌API憑證
GOOGLE_CLIENT_ID=你的_client_id
GOOGLE_CLIENT_SECRET=你的_client_secret
GOOGLE_REFRESH_TOKEN=你的_refresh_token

# 服務器配置
FLASK_ENV=development
PORT=5000
DEBUG=True

# CamelAIOrg代理配置
AGENT_ENDPOINT=http://agents:5001/process
AGENT_API_KEY=你的代理API密鑰

獲取刷新令牌步驟：

使用OAuth 2.0 Playground工具：https://developers.google.com/oauthplayground/
配置項目憑證
篩選所需權限：
- https://www.googleapis.com/auth/forms
- https://www.googleapis.com/auth/drive
- https://www.googleapis.com/auth/drive.file

Web界面訪問

訪問地址：http://localhost:5000 界面功能：

輸入自然語言請求
查看組件間交互流程
查看生成的表單信息和鏈接
查看MCP協議包交換記錄

✨ 主要特性

功能說明

用戶界面
- 支持提交自然語言請求，例如："創建一個包含3個問題的客戶反饋表單"。
- 可查看組件間請求流程。
- 能查看生成的表單詳細信息和鏈接。
內部交互
- 代理服務可解析自然語言並生成MCP請求。
- MCP服務器處理表單創建請求，並與谷歌API通信。
- 請求結果通過MCP協議返回給代理服務。
支持場景
- 客戶反饋收集
- 市場調研問卷
- 活動RSVP表單
- 任意自定義問題類型

📚 詳細文檔

項目架構

google-form-mcp-server/
├── server/                 # MCP服務器實現
│   ├── app.py              # 主Flask應用程序
│   ├── config.py           # 配置管理
│   ├── forms_api.py        # 谷歌表單API集成
│   ├── mcp_handler.py      # MCP協議處理邏輯
│   ├── requirements.txt    # Python依賴項
│   ├── static/             # 靜態資源文件
│   ├── templates/          # HTML模板
│   └── utils/              # 工具函數
├── agents/                 # CamelAIOrg代理服務
│   ├── agent_integration.py # 代理集成實現
│   ├── agent_server.py     # 代理API服務器
│   └── requirements.txt    # Python依賴項
├── Dockerfile              # MCP服務器Docker鏡像配置
├── docker-compose.yml      # 多容器部署配置
├── .env.example            # 環境變量示例文件
└── README.md               # 項目文檔

API接口說明

MCP服務器接口（5000端口）

GET /api/health：健康檢查
GET /api/swagger：查看API文檔

POST /api/create-form：創建新表單

支持JSON格式請求體，如：

{
  "form_name": "客戶反饋表單",
  "questions": [
    { "type": "文本", "prompt": "您的姓名" },
    { "type": "郵箱", "prompt": "您的郵箱地址" }
  ]
}

代理服務接口（5001端口）

POST /process：處理自然語言請求

支持HTTP POST請求，如：

curl -X POST http://localhost:5001/process \
     -H "Content-Type: application/json" \
     -d '{"command": "創建表單", "details": {"question_count": 3}}'