Ohm MCP

OHM-MCP

AI-Powered Python Refactoring & Code Quality Assistant

Works with GitHub Copilot, Cursor IDE, Cline, and any MCP-compatible AI assistant.

---

✨ Core Capabilities

🏗️ Architecture

• God Object Detection
• SOLID Violation Analysis
• Design Pattern Suggestions
• Dependency Injection Refactoring

🔧 Code Quality

• AST Extract Method (100% accurate)
• Dead Code Elimination
• Import Refactoring
• Symbol Renaming (project-wide)
• Duplication Detection

📊 Type Safety

• Type Coverage Analysis
• Type Stub Generation
• Auto Test Generation

⚡ Performance

• O(n²) Pattern Detection
• Hotspot Analysis
• Coverage-Driven Prioritization

🤖 Automation

• Auto-Apply with Rollback
• Operation History
• Quality Dashboard

---

🚀 Quick Start

Installation

📦 Recommended: NPM Method (Auto-installs dependencies)

No installation required! Use NPX to run the latest version automatically:

npx -y ohm-mcp@latest

This is the easiest way to get started. Just add the configuration to your AI assistant (see IDE Configuration below).

MCP Registry: mcp-name: io.github.Murugarajr/ohm-mcp

🐍 Alternative: PyPI Method (For local development)

Use this method when you need to:

• Develop locally with the Python package
• Use a specific Python virtual environment
• Install from source for customization

Install from PyPI:

pip install ohm-mcp

Install from source (for development):

pip install -e .

IDE Configuration

📦 Option 1: NPX (Recommended - Auto-installs dependencies)

🔵 GitHub Copilot (VS Code) with NPX

After publishing to npm:

{

"mcpServers": { "ohm-mcp": { "command": "npx", "args": ["ohm-mcp@latest"] } } }

For local development:

{

"mcpServers": { "ohm-mcp": { "command": "npx", "args": ["--package", "/path/to/ohm-mcp-npm", "ohm-mcp"] } } }

Usage:

• Open Copilot Chat
• Type # and select ohm-mcp tools
• Ask: "Analyze this file and suggest refactorings"

🟣 Cursor IDE with NPX

Global (After publishing to npm):

{

"mcpServers": { "ohm-mcp": { "command": "npx", "args": ["-y", "ohm-mcp@latest"] } } }

For local development:

{

"mcpServers": { "ohm-mcp": { "command": "npx", "args": ["--package", "/path/to/ohm-mcp-npm", "ohm-mcp"] } } }

Usage:

• Open Cursor Chat (Cmd+L / Ctrl+L)
• Tools are automatically available
• Ask: "Use ohm-mcp to detect dead code"

🟢 Cline (VS Code Extension) with NPX

Global (After publishing to npm):

{

"mcpServers": { "ohm-mcp": { "command": "npx", "args": ["-y", "ohm-mcp@latest"] } } }

For local development:

{

"mcpServers": { "ohm-mcp": { "command": "npx", "args": ["--package", "/path/to/ohm-mcp-npm", "ohm-mcp"] } } }

Usage:

• Open Cline panel
• Tools are available in agent context
• Ask: "Analyze type coverage and suggest improvements"

🟠 Antigravity with NPX

Global (After publishing to npm):

{

"mcpServers": { "ohm-mcp": { "command": "npx", "args": ["-y", "ohm-mcp@latest"], "env": { "PYTHONUNBUFFERED": "1" } } } }

Usage:

• Tools are automatically available in Antigravity
• Ask: "Use ohm-mcp to analyze architecture"

🔴 Roo Code with NPX

Global (After publishing to npm):

{

"mcpServers": { "ohm-mcp": { "command": "npx", "args": ["-y", "ohm-mcp@latest"] } } }

Usage:

• Open Roo Code panel
• Tools are available in agent context
• Ask: "Use ohm-mcp to detect duplicates"

⚫ Codex VS Code with NPX

Configuration (config.toml):

[mcp_servers.ohm-mcp]

args = ["-y", "ohm-mcp@latest"] command = "npx"

Usage:

• Open Codex panel
• Tools are automatically available
• Ask: "Use ohm-mcp to suggest design patterns"

🟡 Kilo Code with NPX (Local/Global)

Local (For local development with virtual environment):

{

"mcpServers": { "ohm-mcp": { "command": "/Users/username/project/venv/bin/python", "args": ["-m", "ohm_mcp.server"], "disabled": false, "alwaysAllow": [] } } }

Global (After publishing to npm):

{

"mcpServers": { "ohm-mcp": { "command": "npx", "args": ["-y", "ohm-mcp@latest"] } } }

Usage:

• Open Kilo Code panel
• Tools are available in agent context
• Ask: "Use ohm-mcp for refactoring"

🐍 Option 2: Direct Python (Manual setup)

🔵 GitHub Copilot (VS Code) with Python

First install: pip install ohm-mcp

Then add to .vscode/mcp.json:

{

"servers": { "ohm-mcp": { "command": "python", "args": ["-m", "ohm_mcp.server"] } }, "inputs": [] }

Usage:

• Open Copilot Chat
• Type # and select ohm-mcp tools
• Ask: "Analyze this file and suggest refactorings"

🟣 Cursor IDE with Python

First install: pip install ohm-mcp

Then add to Cursor's MCP settings file (.cursorrules or MCP config):

{

"mcpServers": { "ohm-mcp": { "command": "python", "args": ["-m", "ohm_mcp.server"] } }, "inputs": [] }

Example with virtual environment:

{

"mcpServers": { "ohm-mcp": { "command": "/Users/username/projects/venv/bin/python", "args": ["-m", "ohm_mcp.server"] } } }

Usage:

• Open Cursor Chat (Cmd+L / Ctrl+L)
• Tools are automatically available
• Ask: "Use ohm-mcp to detect dead code"

🟢 Cline (VS Code Extension) with Python

First install: pip install ohm-mcp

Then add to Cline's MCP settings:

{

"mcpServers": { "ohm-mcp": { "command": "python", "args": ["-m", "ohm_mcp.server"] } } }

Example with virtual environment:

{

"mcpServers": { "ohm-mcp": { "command": "/Users/username/projects/venv/bin/python", "args": ["-m", "ohm_mcp.server"] } } }

Note: Cline requires absolute paths for both command and cwd.

Usage:

• Open Cline panel
• Tools are available in agent context
• Ask: "Analyze type coverage and suggest improvements"

🔧 Other MCP-Compatible Clients

Any MCP-compatible client can use this server. General configuration:

{

"mcpServers": { "ohm-mcp": { "command": " ", "args": [" "], "cwd": " " } } }

Finding your Python path:

# Unix/Mac

which python

or

which python3

Windows

where python

---

💡 Quick Usage Examples

Once configured, simply reference tools in your AI assistant chat using the format: use #ohm-mcp.tool_name on the current file or @file_name.py

🗑️ Find Dead Code

Use #ohm-mcp.detect_dead_code on @utils.py

This will detect:

• ✅ Unused imports (import statements never referenced)
• ✅ Unused variables (assigned but never read)
• ✅ Unreachable code (after return/raise/break/continue)
• ✅ Unused functions (defined but never called)
• ✅ Shadowed variables (inner scope hides outer scope variable)

📋 Code Duplication Detection

Use #ohm-mcp.detect_code_duplicates to find duplicates in /path/to/project

Finds:

• ✅ Exact duplicates (100% identical code blocks)
• ✅ Near duplicates (90%+ similarity)
• ✅ Duplicate functions (same structure, different names)
• ✅ Provides refactoring suggestions to eliminate duplication

🏗️ Architecture Analysis

Analyze architecture of @my_module.py using #ohm-mcp.analyze_architecture

Detects:

• ✅ God Objects (classes doing too much)
• ✅ SOLID principle violations
• ✅ Circular dependencies
• ✅ High coupling issues

✂️ Extract Method Refactoring

Use #ohm-mcp.extract_method_ast to extract lines 45-60 from @handler.py into a new function called "process_request"

Automatically:

• ✅ Detects required parameters
• ✅ Identifies return values
• ✅ Generates refactored code
• ✅ Creates unified diff patch

🔄 Safe Symbol Renaming

Use #ohm-mcp.rename_symbol to rename "old_function_name" to "new_function_name" in /path/to/project

Features:

• ✅ AST-based (100% accurate)
• ✅ Detects naming conflicts
• ✅ Shows all occurrences before applying
• ✅ Updates docstrings and comments

📊 Type Coverage Analysis

Analyze type hints in @module.py using #ohm-mcp.analyze_type_hints

Provides:

• ✅ Coverage percentage and grade
• ✅ Functions missing type hints
• ✅ Suggested type annotations
• ✅ Migration plan with priorities

⚡ Performance Optimization

Use #ohm-mcp.analyze_performance on @slow_module.py

Detects:

• ✅ Nested loops (O(n²) complexity)
• ✅ Quadratic list operations
• ✅ Repeated function calls (missing caching)
• ✅ Mutable default arguments
• ✅ Inefficient string concatenation

🧪 Auto-Generate Tests

Generate tests for @calculator.py using #ohm-mcp.generate_characterization_tests

Creates:

• ✅ Happy path test cases
• ✅ Edge cases (None, zero, negative, empty)
• ✅ Ready-to-run pytest code
• ✅ Preserves current behavior before refactoring

🎨 Design Pattern Suggestions

Suggest design patterns for @legacy_code.py using #ohm-mcp.suggest_design_patterns

Recommends:

• ✅ Strategy pattern for long if/elif chains
• ✅ Factory pattern for repetitive object creation
• ✅ Observer pattern for callback hell
• ✅ Decorator pattern for cross-cutting concerns

🔧 Import Refactoring

Use #ohm-mcp.refactor_imports to update all files in /path/to/project from "old.module" to "new.module"

Handles:

• ✅ Direct imports (import old.module)
• ✅ From imports (from old.module import X)
• ✅ Submodule imports
• ✅ Import aliases

---

🎯 Key Tools (30 Total)

📋 General Analysis & Planning (4 tools)

🏗️ Architecture & Design (4 tools)

| Tool | Purpose | Out