Google Form MCP Server

一个集成Google Forms API和CamelAIOrg代理的自然语言表单管理系统

教育与学习工具开发者工具 #智能表单 #自然语言处理 #API集成 #自动化工具 .Python

评分 : 2.5分

下载量 : 21

更新时间 : 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}}'