谷歌表单与CamelAIOrg集成项目

项目概述

此项目展示了如何通过Model Context Protocol（MCP）将谷歌表单与CamelAIOrg代理服务集成。用户可以通过自然语言请求创建表单，系统内部则通过MCP协议进行交互。

技术文档

功能说明

1. 用户界面

   • 提交自然语言请求（如："创建一个包含3个问题的客户反馈表单"）
   • 查看组件间请求流程
   • 查看生成的表单详细信息和链接

2. 内部交互

   • 代理服务解析自然语言并生成MCP请求
   • MCP服务器处理表单创建请求并与谷歌API通信
   • 请求结果通过MCP协议返回给代理服务

3. 支持场景

   • 客户反馈收集
   • 市场调研问卷
   • 活动 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               # 项目文档

安装与运行

使用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密钥

获取刷新令牌步骤：

1. 使用OAuth 2.0 Playground工具：https://developers.google.com/oauthplayground/
2. 配置项目凭证
3. 筛选所需权限：
   • https://www.googleapis.com/auth/forms
   • https://www.googleapis.com/auth/drive
   • https://www.googleapis.com/auth/drive.file

使用说明

Web界面访问

访问地址：http://localhost:5000

界面功能：

1. 输入自然语言请求
2. 查看组件间交互流程
3. 查看生成的表单信息和链接
4. 查看MCP协议包交换记录

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请求，如：
    ```bash
    curl -X POST http://localhost:5001/process \
         -H "Content-Type: application/json" \
         -d '{"command": "创建表单", "details": {"question_count": 3}}'

开发细节

项目依赖

• Python 3.8+
• Flask框架
• google-auth库
• requests库

贡献指南

1. 提交代码前请先格式化（black .）
2. 提交PR时需包含单元测试
3. 现有功能不足之处请在Issues中提出

许可证

项目采用MIT许可证，具体条款参见LICENSE文件。

致谢

感谢以下项目的支持：

• Model Context Protocol（MCP）社区
• CamelAIOrg开发团队
• 谷歌开发者服务