Multi-MCP AI Agent

What is Multi-MCP AI Agent?

An agentic AI system that coordinates multiple MCP (Model Control Protocol) servers to deliver capabilities ranging from basic math to Google Workspace and web scraping. It includes a Telegram bot interface and Server-Sent Events (SSE) for real-time communication, targeting developers building modular AI agents.

How to use Multi-MCP AI Agent?

After cloning the repository, create a virtual environment with uv venv, activate it, install dependencies with uv sync, and set up environment variables for Gemini API key, Telegram bot token, and Google OAuth credentials. Start the agent with uv run agent.py or the Telegram bot server with uv run telegram_sse_server.py. Configure MCP servers in config/profiles.yaml and models in config/models.json.

Key features of Multi-MCP AI Agent

• Multi-MCP architecture for distributed processing
• Cognitive modules: perception, memory, decision, action
• Google Workspace integration (Gmail, Drive, Sheets)
• Web scraping, content extraction, DuckDuckGo search
• Real-time Telegram bot and SSE communication
• Session handling, context management, strategic decision making

Use cases of Multi-MCP AI Agent

• Automating document processing with semantic search and content extraction
• Fetching real-time data from web searches and Google Workspace
• Building a conversational assistant with Telegram bot interface
• Orchestrating multiple MCP services for complex multi-step tasks

FAQ from Multi-MCP AI Agent

What external services does Multi-MCP AI Agent integrate with?

It integrates with Google Workspace (Gmail, Google Drive, Google Sheets), DuckDuckGo search, and web scraping/content extraction services.

What are the prerequisites to run Multi-MCP AI Agent?

Python 3.11+, UV package manager, a Telegram Bot Token (for bot functionality), and Google Cloud credentials (for Google Workspace integration).

How do I start the agent and the Telegram server?

Use uv run agent.py for the main agent and uv run telegram_sse_server.py to start the Telegram bot server with SSE support.

Which MCP servers are included in Multi-MCP AI Agent?

Four servers: Basic Operations (math, image processing, file ops), Document Processing (indexing, search, content extraction, image captioning), Web Integration (DuckDuckGo search, web content fetching, rate-limited requests), and Google Workspace (Gmail, Sheets, Drive, URL scraper).

Does Multi-MCP AI Agent support real-time communication?

Yes, through a Telegram bot interface and Server-Sent Events (SSE) for live event streaming and updates.