MCP Router

🚀 MCP Router

The MCP Router is a Python package designed to interact with servers adhering to the Model Context Protocol (MCP) and integrate OpenRouter's LLM capabilities. It offers a backend for managing MCP servers, executing agent - based tasks, and coordinating complex workflows using the Upsonic framework.

🚀 Quick Start

The MCP Router simplifies the interaction with MCP - compliant servers and integrates OpenRouter's LLM features. It provides a comprehensive solution for managing servers, executing tasks, and coordinating workflows.

✨ Features

• MCP Server Management: Add, edit, and delete MCP servers.
• OpenRouter Integration: Directly query OpenRouter models to perform AI - assisted tasks.
• Upsonic Integration: Coordinate complex multi - step workflows using Upsonic.
• Intelligent Task Analysis: Automatically determine the tools required to complete a task.
• MCP Protocol Support: Standardized interaction with MCP servers.
• API Framework: Expose functionality through REST API endpoints.

🔧 Technical Details

🏗️ Architecture

The structure of the package is as follows:

mcp_router/
├── __init__.py
├── main.py
├── cli/           # Command - line interface
├── core/          # Core MCP and Upsonic integration
├── server_management/ # MCP server management
└── utils/         # Utility functions

📦 Installation

Prerequisites

• Python 3.8+
• Docker (Optional, recommended for running MCP servers)

Clone the Repository

git clone https://github.com/codewithkenzo/mcp-router.git
cd mcp-router

Install Python Packages

# Create a virtual environment (recommended)
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Install the package in development mode
pip install -e .

💻 Usage Examples

Basic Usage

import mcp_router

# Initialize an MCP server manager
server_manager = mcp_router.core.server_manager.ServerManager()

# Get available MCP servers
servers = server_manager.get_servers()

# Use OpenRouter integration
from mcp_router.core import openrouter
response = openrouter.query("Tell me about MCP")

Advanced Usage

# At the project root directory with the virtual environment activated
python -m mcp_router.cli.cli --help

📚 Documentation

Components

MCP Server Management

The server management module handles:

• Reading MCP server configurations from ~/.cursor/mcp.json.
• Starting and stopping MCP servers.
• Communicating with MCP servers.

Upsonic Integration

Upsonic integration allows:

• Creating agent workflows using MCP tools.
• Analyzing tasks to determine required tools.
• Executing multi - step tasks with various MCP capabilities.

OpenRouter Integration

The OpenRouter module provides:

• Access to multiple LLM providers through a single API.
• Query generation and response handling.
• Token usage tracking.

🤝 Contribution

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/amazing - feature).
3. Commit your changes (git commit -m 'Add some amazing features').
4. Push to the branch (git push origin feature/amazing - feature).
5. Open a Pull Request.

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for details.

🙏 Acknowledgments

• Model Context Protocol for providing the MCP specification.
• OpenRouter for providing access to various LLM models.
• Upsonic for providing the agent framework.