Content
# Multi-Agent MCP Orchestrator
An enterprise-grade, autonomous AI orchestration system built with LangGraph, utilizing the Model Context Protocol (MCP) to seamlessly connect LLMs to local environments, vector databases, and cloud APIs.
## Architectural Highlights
### 1. The Supervisor Routing (LangGraph)
* Transitioned from a monolithic tool-calling agent to a distributed `MultiServerMCPClient` architecture.
* Implemented strict system prompt injection to control agent behavior dynamically (e.g., forcing Google Sheets defaults) without polluting user queries.
* Handled state routing via `GraphState` to allow seamless multi-step tool chaining across completely isolated MCP servers.
### 2. Self-Healing RAG Vault (`ragsystem.py`)
* Built a custom Pinecone Hybrid Search vector database with LlamaParse for structural markdown extraction.
* **Wipe-and-Replace Mechanism:** Implemented pre-ingestion metadata filtering (`index.delete(filter={"source": filepath})`). This prevents vector duplication when re-ingesting updated source files, maintaining a pristine context window.
### 3. Custom Google Workspace Server (`workspace_custom.py`)
* Bypassed limited community MCP packages to build a raw Python MCP server interacting directly with Google Docs and Sheets REST APIs.
* **Capabilities:** * `create_sheet` & `write_sheet`: Matrix-based (2D array) row appending using Google's `USER_ENTERED` parsing.
* `create_doc` & `append_doc`: Dynamic EOF index calculation to securely inject text into heavily nested Google Docs JSON trees.
### 4. Cross-Platform Integrations
This orchestrator successfully routes complex workflows across multiple isolated domains in a single conversational turn:
* **Local Filesystem:** Read/Write access via standard I/O transport.
* **Notion:** Document retrieval via official `@modelcontextprotocol/server-notion`.
* **DuckDuckGo:** Zero-auth web search via `duckduckgo-mcp-server`.
* **Todoist:** Task management and creation via a custom FastMCP REST API server.
---
## Prerequisites & Installation
### 1. Environment Setup
This project uses `uv` for lightning-fast package management. Ensure Python 3.12+ and `uv` are installed.
```bash
# Clone the repository
git clone [https://github.com/yourusername/multi-agent-orchestrator.git](https://github.com/yourusername/multi-agent-orchestrator.git)
cd multi-agent-orchestrator
# Install dependencies via uv
uv venv
uv pip install -r requirements.txt
