🧘 Dev Guru

Your AI-powered code consultation MCP server.

When you're stuck, afraid, or just lazy to ask for help — Dev Guru is here.

💡 What is Dev Guru?

Dev Guru is a specialized MCP (Model Context Protocol) server that acts as an on-demand senior code consultant for AI agents. It routes coding problems to the most suitable AI model based on the requested expertise level, providing structured, actionable feedback.

Think of it as a second brain for your AI agent — a guru it can consult when facing tough coding decisions.

🎯 Use Cases

✨ Features

• 🧠 Expert-based Routing — Automatically selects the best AI model for the task:

  • novice → Gemini (fast, efficient)

  • medium → Claude (balanced, analytical)

  • expert → OpenAI GPT (deep reasoning)

• 🔀 OpenRouter Fallback — If a primary API key is missing, seamlessly falls back to OpenRouter

• 🎛️ Configurable Models — Choose exactly which model to use per level via environment variables

• ⚡ FastMCP Core — High-performance MCP server implementation

• 📦 Skill Management API — Dynamic skill installation and management via REST

• 🐳 Docker Ready — Multi-stage build with uv for efficient containerized deployments

• 🧩 Agno Framework — Leverages Agno for agent orchestration and structured outputs

🚀 Quick Start

Prerequisites

• Python 3.12+

• uv (recommended)

• At least one API key: Gemini, Anthropic, OpenAI, or OpenRouter

Installation

# Clone the repository
git clone https://github.com/your-user/dev-guru.git
cd dev-guru

# Create your environment file
cp .env.example .env
# Edit .env with your API keys

# Install dependencies
uv sync

Running

# Start the full API + MCP server
uv run python main.py

Docker

docker compose up --build

⚙️ Configuration

Environment Variables

Tip: You only need an OPENROUTER_API_KEY to use all three levels — it acts as a universal fallback for any missing provider key.

🔌 MCP Configuration

Add Dev Guru to your MCP client (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "dev-guru": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/dev-guru",
        "run",
        "python",
        "src/server.py"
      ]
    }
  }
}

📡 API Endpoints

Skill Management

MCP Tool

🧪 Testing

PYTHONPATH=. uv run pytest

🏗️ Architecture

graph LR
    A[AI Agent] -->|MCP Protocol| B[Dev Guru Server]
    B -->|novice| C[Gemini]
    B -->|medium| D[Claude]
    B -->|expert| E[GPT-5.3-codex]
    B -.->|fallback| F[OpenRouter]
    F --> C
    F --> D
    F --> E

Built with 🧘 by devs, for devs.