Google Forms MCP Server with CamelAIOrg Agents Integration

A Model Context Protocol (MCP) server that integrates with Google Forms API and CamelAIOrg Agents to create, modify, and retrieve forms using natural language instructions.

Overview

This project enables the creation and management of Google Forms through natural language requests. It consists of two main components:

1. MCP Server: A Flask-based server that implements the Model Context Protocol (MCP) to expose Google Forms operations as tools.
2. CamelAIOrg Agents: An AI agent framework that processes natural language requests and translates them into MCP tool calls.

The system features a dark-themed UI with an animated visualization of the request flow between frontend, agents, MCP server, and Google APIs.

Features

• Create Google Forms from natural language requests
• Add different types of questions (text, paragraph, multiple-choice, checkbox)
• Retrieve form responses
• Visualize the flow of requests and responses
• Dark-themed UI with animations
• Full MCP (Model Context Protocol) compliance
• Containerized with Docker for easy deployment

Architecture

┌─────────────┐    ┌─────────────┐    ┌────────────┐    ┌────────────┐
│             │    │             │    │            │    │            │
│   Frontend  │◄──►│ CamelAIOrg  │◄──►│ MCP Server │◄──►│  Google    │
│    (UI)     │    │   Agents    │    │            │    │ Forms API  │
│             │    │             │    │            │    │            │
└─────────────┘    └─────────────┘    └────────────┘    └────────────┘

Process Flowchart

This diagram illustrates how a user request flows through the system:

graph TD
    subgraph "User Interface"
        A[Frontend UI]
    end
    
    subgraph "Processing Logic"
        B((CamelAIOrg Agent))
        C((MCP Server))
    end
    
    subgraph "External Service"
        D{{Google Forms API}}
    end
    
    A -->|"1. User enters: Create feedback form"| B
    B -->|"2. Interprets request, sends tool call"| C
    C -->|"3. Translates to API request"| D
    D -->|"4. Returns formId and URL"| C
    C -->|"5. Processes API response"| B
    B -->|"6. Formats final result to UI"| A
    
    style B fill:#f9d423,stroke:#333,stroke-width:2px,color:#333
    style C fill:#8ecae6,stroke:#333,stroke-width:2px,color:#333

Role of Components

• Frontend UI: Provides the user interface for inputting natural language requests and visualizing the process and results.
• CamelAIOrg Agent (Highlighted Yellow):
  • Responsibility: Interpretation and Planning.
  • Receives the raw natural language request.
  • Parses the request to understand the user’s intent and extract key details (form title, questions, types, etc.).
  • Determines the sequence of actions (MCP tool calls) needed to fulfill the request.
  • Communicates with the MCP Server using the defined tool schema.
• MCP Server (Highlighted Blue):