Google Forms MCP Server with CamelAIOrg Agents Integration

Google Forms MCP Server with CamelAIOrg Agents Integration

adarshp14

开发者工具
访问服务器

README

集成 CamelAIOrg Agents 的 Google Forms MCP 服务器

一个模型上下文协议 (MCP) 服务器，集成了 Google Forms API 和 CamelAIOrg Agents，可以使用自然语言指令创建、修改和检索表单。

概述

本项目支持通过自然语言请求创建和管理 Google 表单。它由两个主要组件组成：

  1. MCP 服务器: 一个基于 Flask 的服务器，实现了模型上下文协议 (MCP)，将 Google Forms 操作暴露为工具。
  2. CamelAIOrg Agents: 一个 AI 代理框架，处理自然语言请求并将其转换为 MCP 工具调用。

该系统具有一个深色主题的 UI，并以动画形式可视化前端、代理、MCP 服务器和 Google API 之间的请求流程。

特性

  • 从自然语言请求创建 Google 表单
  • 添加不同类型的问题（文本、段落、单选题、复选框）
  • 检索表单回复
  • 可视化请求和响应的流程
  • 具有动画效果的深色主题 UI
  • 完全符合 MCP（模型上下文协议）
  • 使用 Docker 容器化，易于部署

架构

┌─────────────┐    ┌─────────────┐    ┌────────────┐    ┌────────────┐
│             │    │             │    │            │    │            │
│   前端  │◄──►│ CamelAIOrg  │◄──►│ MCP 服务器 │◄──►│  Google    │
│    (UI)     │    │   Agents    │    │            │    │ Forms API  │
│             │    │             │    │            │    │            │
└─────────────┘    └─────────────┘    └────────────┘    └────────────┘

流程图

此图说明了用户请求如何在系统中流动：

graph TD
    subgraph "用户界面"
        A[前端 UI]
    end
    
    subgraph "处理逻辑"
        B((CamelAIOrg Agent))
        C((MCP 服务器))
    end
    
    subgraph "外部服务"
        D{{Google Forms API}}
    end
    
    A -->|"1. 用户输入：创建反馈表单"| B
    B -->|"2. 解释请求，发送工具调用"| C
    C -->|"3. 转换为 API 请求"| D
    D -->|"4. 返回 formId 和 URL"| C
    C -->|"5. 处理 API 响应"| B
    B -->|"6. 将最终结果格式化为 UI"| A
    
    style B fill:#f9d423,stroke:#333,stroke-width:2px,color:#333
    style C fill:#8ecae6,stroke:#333,stroke-width:2px,color:#333

组件角色

  • 前端 UI: 提供用户界面，用于输入自然语言请求并可视化流程和结果。
  • CamelAIOrg Agent (黄色高亮显示):
    • 职责: 解释和规划。
    • 接收原始自然语言请求。
    • 解析请求以理解用户的意图并提取关键细节（表单标题、问题、类型等）。
    • 确定满足请求所需的动作序列（MCP 工具调用）。
    • 使用定义的工具模式与 MCP 服务器通信。
  • MCP 服务器 (蓝色高亮显示):
    • 职责: 执行和抽象。
    • 接收来自 Agent 的结构化工具调用。
    • 充当 Google Forms API 的专用接口。
    • 将抽象工具调用（例如，create_form）转换为具体的 Google Forms API 请求。
    • 处理与 Google Forms API 的身份验证、通信和错误处理。
    • 以标准化的 MCP 格式将 Google Forms API 的结果返回给 Agent。

为什么需要 MCP 服务器？

模型上下文协议 (MCP) 服务器充当关键的中间层，原因如下：

  1. 抽象: 它隐藏了底层 Google Forms API 的复杂性，使其对 CamelAI Agent 不可见。 Agent 不需要知道 Google API 的特定端点、身份验证方法或请求/响应格式。 它只需要知道简化的 MCP 工具模式（例如，create_form，add_question）。
  2. 模块化和可重用性: Agent 可以设计为与任何暴露 MCP 接口的服务进行交互。 如果您想添加对另一种表单服务（例如，Typeform）的支持，您可以为其创建一个单独的 MCP 服务器，并且 Agent 可以通过最小的更改来使用它，只需学习新的 MCP 工具模式即可。
  3. 标准化: MCP 提供了一种标准方式，供 AI 模型/代理与外部工具和 API 交互。 这促进了互操作性。
  4. 安全和控制: MCP 服务器可以强制执行策略、安全地管理 API 密钥、处理速率限制，并提供对外部 API 的受控网关，而不是将敏感凭据或复杂逻辑直接嵌入到代理中。
  5. 可维护性: 将 API 交互逻辑（MCP 服务器）与自然语言理解和规划逻辑（Agent）分离，使系统更易于维护和更新。 对 Google Forms API 的更改只需要更新 MCP 服务器，而无需更新 Agent 本身。

前提条件

  • Docker 和 Docker Compose
  • Google Cloud Platform 帐户
  • 启用 Google Forms API
  • 来自 Google Cloud Console 的 OAuth2 凭据

设置说明

1. 克隆存储库

git clone https://github.com/yourusername/google-form-mcp-server.git
cd google-form-mcp-server

2. 设置 Google Forms API

  1. 转到 Google Cloud Console
  2. 创建一个新项目
  3. 启用 Google Forms API 和 Google Drive API
  4. 创建 OAuth2 凭据
    • Web 应用程序类型
    • 添加授权的重定向 URI：http://localhost:5000/oauth2callback
  5. 下载凭据 JSON 文件

3. 配置环境变量

在根目录中创建一个 .env 文件：

# Google API 凭据
GOOGLE_CLIENT_ID=your_client_id_here
GOOGLE_CLIENT_SECRET=your_client_secret_here
GOOGLE_REFRESH_TOKEN=your_refresh_token_here

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

# CamelAIOrg Agents 配置
AGENT_ENDPOINT=http://agents:5001/process
AGENT_API_KEY=your_agent_api_key_here

要获取刷新令牌：

  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
  4. 将授权码交换为令牌
  5. 将刷新令牌复制到您的 .env 文件

4. 使用 Docker Compose 构建和运行

docker-compose up --build

这将启动 MCP 服务器（在端口 5000 上）和 CamelAIOrg Agents 服务（在端口 5001 上）。

用法

Web 界面

在 http://localhost:5000 访问 Web 界面

该界面允许您：

  1. 输入自然语言请求（例如，“创建一个包含 3 个问题的反馈表单”）
  2. 查看组件之间的请求流程
  3. 查看生成的表单详细信息和链接
  4. 查看正在交换的 MCP 数据包

API 端点

MCP 服务器端点 (端口 5000)

  • GET /api/health - 健康检查
  • GET /api/schema - 获取 MCP 工具模式
  • POST /api/process - 处理 MCP 请求

CamelAIOrg Agent 端点 (端口 5001)

  • GET /health - 健康检查
  • GET /schema - 获取代理功能
  • POST /process - 处理自然语言请求

示例请求

以下是一些您可以尝试的自然语言请求示例：

  1. "创建一个客户反馈表单，包含一个 1-5 的评分问题和一个用于其他评论的文本问题"
  2. "创建一个关于远程工作偏好的调查，包含 3 个多项选择题"
  3. "创建一个包含姓名、电子邮件和出席选项的活动 RSVP 表单"

MCP 协议格式

MCP 服务器接受以下格式的请求：

{
  "transaction_id": "unique_transaction_id",
  "tool_name": "create_form",
  "parameters": {
    "title": "Form Title",
    "description": "Form Description"
  }
}

并响应：

{
  "transaction_id": "unique_transaction_id",
  "status": "success",
  "result": {
    "form_id": "form_id",
    "response_url": "https://docs.google.com/forms/d/form_id/viewform",
    "edit_url": "https://docs.google.com/forms/d/form_id/edit",
    "title": "Form Title"
  }
}

开发

项目结构

google-form-mcp-server/
├── server/                 # MCP 服务器
│   ├── app.py              # 主要 Flask 应用程序
│   ├── config.py           # 配置
│   ├── forms_api.py        # Google Forms API 集成
│   ├── mcp_handler.py      # MCP 协议处理程序
│   ├── requirements.txt    # Python 依赖项
│   ├── static/             # 静态资源
│   ├── templates/          # HTML 模板
│   └── utils/              # 实用函数
├── agents/                 # CamelAIOrg Agents
│   ├── agent_integration.py # Agent 实现
│   ├── agent_server.py     # Agent API 服务器
│   └── requirements.txt    # Python 依赖项
├── Dockerfile              # MCP 服务器 Dockerfile
├── docker-compose.yml      # Docker Compose 配置
├── .env.example            # 示例环境变量
└── README.md               # 项目文档

无需 Docker 运行

要无需 Docker 运行 MCP 服务器：

cd server
pip install -r requirements.txt
python app.py

要无需 Docker 运行 Agents 服务：

cd agents
pip install -r requirements.txt
python agent_server.py

许可证

MIT

致谢

  • Google Forms API
  • CamelAIOrg 及其代理框架
  • 模型上下文协议 (MCP) 规范

推荐服务器

Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器，它使大型语言模型能够通过结构化的可访问性快照与网页进行交互，而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

一个由人工智能驱动的工具，可以从自然语言描述生成现代化的用户界面组件，并与流行的集成开发环境（IDE）集成，从而简化用户界面开发流程。

官方
精选
本地
TypeScript
MCP Package Docs Server

MCP Package Docs Server

促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档，通过多语言支持和性能优化来增强软件开发。

精选
本地
TypeScript
Claude Code MCP

Claude Code MCP

一个实现了 Claude Code 作为模型上下文协议（Model Context Protocol, MCP）服务器的方案，它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力（代码生成、编辑、审查和文件操作）。

精选
本地
JavaScript
@kazuph/mcp-taskmanager

@kazuph/mcp-taskmanager

用于任务管理的模型上下文协议服务器。它允许 Claude Desktop（或任何 MCP 客户端）在基于队列的系统中管理和执行任务。

精选
本地
JavaScript
mermaid-mcp-server

mermaid-mcp-server

一个模型上下文协议 (MCP) 服务器，用于将 Mermaid 图表转换为 PNG 图像。

精选
JavaScript
Jira-Context-MCP

Jira-Context-MCP

MCP 服务器向 AI 编码助手（如 Cursor）提供 Jira 工单信息。

精选
TypeScript
Linear MCP Server

Linear MCP Server

一个模型上下文协议（Model Context Protocol）服务器，它与 Linear 的问题跟踪系统集成，允许大型语言模型（LLM）通过自然语言交互来创建、更新、搜索和评论 Linear 问题。

精选
JavaScript
Sequential Thinking MCP Server

Sequential Thinking MCP Server

这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决，支持修订，并通过完整的 MCP 集成来实现多条解决方案路径。

精选
Python
Curri MCP Server

Curri MCP Server

通过管理文本笔记、提供笔记创建工具以及使用结构化提示生成摘要，从而实现与 Curri API 的交互。

官方
本地
JavaScript