Ohm MCP

AST-based Python refactoring MCP server with safe automated refactorings and rollback

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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:

Terminal

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:

Terminal

pip install ohm-mcp

Install from source (for development):

Terminal

pip install -e .

IDE Configuration

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

🔵 GitHub Copilot (VS Code) with NPX

After publishing to npm:

config.json

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

For local development:

config.json

{
  "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):

config.json

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

For local development:

config.json

{
  "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):

config.json

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

For local development:

config.json

{
  "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):

config.json

{
  "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):

config.json

{
  "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):

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):

config.json

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

Global (After publishing to npm):

config.json

{
  "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:

config.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):

config.json

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

Example with virtual environment:

config.json

{
  "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:

config.json

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

Example with virtual environment:

config.json

{
  "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:

config.json

{
  "mcpServers": {
    "ohm-mcp": {
      "command": "<python-interpreter-path>",
      "args": ["<path-to-mcp_server.py>"],
      "cwd": "<project-directory>"
    }
  }
}

Finding your Python path:

bash

# 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

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

Code

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

Code

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

Code

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

Code

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

8mo ago

Most recent push to the default branch.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Ohm MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "ohm-mcp": { "command": "npx", "args": ["-y","ohm-mcp@latest"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ohm-mcp?style=directory)](https://allmcps.com/mcp/ohm-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/ohm-mcp"><img src="https://allmcps.com/api/badge/ohm-mcp?style=directory" alt="Ohm MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

11/15 checks healthy over the last 45d

36Quality signal: Fair · 36/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 5d ago via OSV.dev · ohm-mcp@latest (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Ohm MCP →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients

Ohm MCP

AST-based Python refactoring MCP server with safe automated refactorings and rollback

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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:

Terminal

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:

Terminal

pip install ohm-mcp

Install from source (for development):

Terminal

pip install -e .

IDE Configuration

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

🔵 GitHub Copilot (VS Code) with NPX

After publishing to npm:

config.json

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

For local development:

config.json

{
  "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):

config.json

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

For local development:

config.json

{
  "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):

config.json

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

For local development:

config.json

{
  "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):

config.json

{
  "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):

config.json

{
  "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):

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):

config.json

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

Global (After publishing to npm):

config.json

{
  "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:

config.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):

config.json

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

Example with virtual environment:

config.json

{
  "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:

config.json

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

Example with virtual environment:

config.json

{
  "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:

config.json

{
  "mcpServers": {
    "ohm-mcp": {
      "command": "<python-interpreter-path>",
      "args": ["<path-to-mcp_server.py>"],
      "cwd": "<project-directory>"
    }
  }
}

Finding your Python path:

bash

# 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

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

Code

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

Code

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

Code

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

Code

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

8mo ago

Most recent push to the default branch.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Ohm MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "ohm-mcp": { "command": "npx", "args": ["-y","ohm-mcp@latest"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ohm-mcp?style=directory)](https://allmcps.com/mcp/ohm-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/ohm-mcp"><img src="https://allmcps.com/api/badge/ohm-mcp?style=directory" alt="Ohm MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

11/15 checks healthy over the last 45d

36Quality signal: Fair · 36/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity1/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 5d ago via OSV.dev · ohm-mcp@latest (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Ohm MCP →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients