# MCP Plus

A lightweight, open suite of MCP tools designed to enhance LLM capabilities.

---

## Overview

**MCP Plus** is a Model Context Protocol (MCP) server that extends AI agents with powerful, purpose-built tools for codebase understanding, task delegation, multi-agent coordination, and project management. Built to be **open** and **lightweight**, it runs as a single FastMCP server and integrates seamlessly with any MCP-compatible client.

---

## Tools

| Function | Description |
|----------|-------------|
| `context_engine` | Ask natural language questions about any codebase. Returns comprehensive analysis with file references that the LLM can read using view_file tools. |
| `subagent` | Delegates basic tasks to a smaller, faster LLM that can read/write files autonomously. |
| `chatroom_send_message` | Post a message to a project's chatroom. |
| `chatroom_read_messages` | Read recent messages from the chatroom. |
| `todo_list` | View all todos for a project. |
| `todo_update` | Add, complete, or remove todos. |

### Context Engine

A fast and cheap context retrieval tool that enables LLMs to understand your codebase with speed and accuracy. Better context = better code.

It can analyze an entire codebase in 1 second for less than $0.01.

**Features:**

- Intelligent file selection based on question relevance
- File references with line numbers for the LLM to read
- Markdown-formatted analysis
- Overview of file tree

### Subagent

A specialized, efficient agent capable of autonomous file operations. Use this to delegate basic tasks, allowing the main model to focus on higher-level reasoning and complex architecture.

### Chatroom

A multi-agent coordination tool that facilitates communication between agents working on the same codebase. It ensures agents stay synchronized and avoid duplicating work.

### Todo

A simple task management system for tracking project-specific to-dos directly within your workflow. Useful if your CLI or IDE lacks integrated task management.

---

## Installation

### Prerequisites

- Python 3.8+
- OpenRouter API key

## Configuration

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "mcp_plus": {
      "command": "/path/to/mcp_plus/venv/bin/python",
      "args": ["/path/to/mcp_plus/mcp_server.py"],
      "env": {
        "OPENROUTER_API_KEY": "your_api_key_here",
        "MODEL_NAME": "google/gemini-2.5-flash-lite",  
        "SUBAGENT_MODEL": "moonshotai/kimi-k2-thinking" 
      }
    }
  }
}
```

Or run directly:

```bash
./run_server.sh
```

---

## License

MIT

---