# 🌐 OmniAgent MCP Mesh

[![CI Pipeline](https://github.com/ASHOKMUKHERJEE6/omni-agent-mcp-mesh/actions/workflows/ci.yml/badge.svg)](https://github.com/ASHOKMUKHERJEE6/omni-agent-mcp-mesh/actions)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)

An enterprise-grade, asynchronous Multi-Agent Orchestration & Model Context Protocol (MCP) Router Mesh framework in Python.

---

## ⚡ Features

- **Asynchronous DAG Engine:** High-performance, concurrent Directed Acyclic Graph execution with automatic deadlock detection, cycle validation, retry policies, and timeouts.
- **Model Context Protocol (MCP) Router:** Standardized JSON-RPC 2.0 transport router for registering and dispatching tool invocations across LLM agent swarms.
- **Consensus-Driven Agent Swarms:** Multi-agent role hierarchy (Planner, Coder, Evaluator, Security Auditor) with asynchronous consensus broadcasting.
- **Semantic Vector-Graph Memory:** Hybrid context store for dynamic session state persistence and RAG retrieval.
- **REST & Telemetry Gateway:** Built-in FastAPI server for remote execution, system health monitoring, and tool management.
- **Production Ready:** Includes Docker containerization, `docker-compose`, GitHub Actions CI/CD pipeline, and full Pytest coverage.

---

## 🏗️ Architecture Overview

```
                        ┌─────────────────────────────────┐
                        │      FastAPI REST Gateway       │
                        └────────────────┬────────────────┘
                                         │
                        ┌────────────────▼────────────────┐
                        │        MCP Router Hub           │
                        │    (JSON-RPC 2.0 Tools)         │
                        └────────────────┬────────────────┘
                                         │
               ┌─────────────────────────┼─────────────────────────┐
               │                         │                         │
     ┌─────────▼──────────┐   ┌──────────▼──────────┐   ┌──────────▼──────────┐
     │  Async DAG Engine  │   │  Consensus Swarms   │   │ Vector-Graph Store  │
     └────────────────────┘   └─────────────────────┘   └─────────────────────┘
```

---

## 🚀 Quickstart

### Installation

```bash
git clone https.github.com/ASHOKMUKHERJEE6/omni-agent-mcp-mesh.git
cd omni-agent-mcp-mesh
pip install .[dev]
```

### Running the API Server

```bash
uvicorn omni_mesh.api.main:app --reload --port 8000
```

### Running Docker

```bash
docker-compose up --build
```

---

## 🧪 Testing

Run the full async test suite:

```bash
python -m pytest
```

---

## 📜 License

Distributed under the MIT License. See `LICENSE` for more information.