murugarajr avatar

Ohm Mcp

murugarajr/ohm-mcp

Brings AST-powered Python refactoring directly into Claude through MCP tools. You get extract method, dead code elimination, god object detection, SOLID violation analysis, and project-wide symbol renaming. The server wraps Python's ast module to deliver safe, rollback-capable transformations without the usual grep-and-replace chaos. Install via npx or pip, then call tools like analyze_architecture or detect_dead_code from any MCP client. Built for workflows where you want concrete refactoring operations, not just suggestions. Includes type coverage analysis, duplicate detection, and a quality dashboard that surfaces O(n²) patterns and test coverage gaps. The operation history lets you undo changes if a refactoring goes sideways.

GitHub stars
2
tools
30
transport
STDIO
last updated
Jan 24, 2026

Tools

30 tools

Public tool metadata for what this MCP can expose to an agent.

analyze_codebaseComprehensive code analysis

Comprehensive code analysis

No parameter schema in public metadata yet.

propose_function_refactorFunction-level refactor planning

Function-level refactor planning

No parameter schema in public metadata yet.

explain_refactoringExplain refactoring patterns

Explain refactoring patterns

No parameter schema in public metadata yet.

create_refactor_patchGenerate unified diff patches

Generate unified diff patches

No parameter schema in public metadata yet.

analyze_architectureDetect God Objects, SOLID violations

Detect God Objects, SOLID violations

No parameter schema in public metadata yet.

suggest_design_patternsRecommend patterns (Strategy, Factory, Observer)

Recommend patterns (Strategy, Factory, Observer)

No parameter schema in public metadata yet.

analyze_tight_couplingFind coupling issues

Find coupling issues

No parameter schema in public metadata yet.

suggest_di_refactorGenerate DI code

Generate DI code

No parameter schema in public metadata yet.

extract_method_astExtract code into function

Extract code into function

No parameter schema in public metadata yet.

suggest_extractable_methodsFind extractable blocks

Find extractable blocks

No parameter schema in public metadata yet.

detect_dead_codeFind unused code

Find unused code

No parameter schema in public metadata yet.

refactor_importsUpdate imports project-wide

Update imports project-wide

No parameter schema in public metadata yet.

refactor_single_file_importsRefactor imports in one file

Refactor imports in one file

No parameter schema in public metadata yet.

analyze_wildcard_importsFind wildcard imports

Find wildcard imports

No parameter schema in public metadata yet.

rename_symbolRename across codebase

Rename across codebase

No parameter schema in public metadata yet.

detect_code_duplicatesFind DRY violations

Find DRY violations

No parameter schema in public metadata yet.

extract_function_codeExtract single function code

Extract single function code

No parameter schema in public metadata yet.

apply_function_refactorApply function-level refactor

Apply function-level refactor

No parameter schema in public metadata yet.

analyze_type_hintsCheck type coverage

Check type coverage

No parameter schema in public metadata yet.

generate_type_stubCreate .pyi files

Create .pyi files

No parameter schema in public metadata yet.

generate_characterization_testsAuto-generate tests

Auto-generate tests

No parameter schema in public metadata yet.

generate_test_for_functionSingle function tests

Single function tests

No parameter schema in public metadata yet.

suggest_testsSuggest test strategies

Suggest test strategies

No parameter schema in public metadata yet.

analyze_performanceFind bottlenecks

Find bottlenecks

No parameter schema in public metadata yet.

prioritize_by_coverageRisk-based prioritization

Risk-based prioritization

No parameter schema in public metadata yet.

apply_refactoringAuto-apply refactoring with safety checks

Auto-apply refactoring with safety checks

No parameter schema in public metadata yet.

rollback_refactoringRollback previous refactoring

Rollback previous refactoring

No parameter schema in public metadata yet.

show_refactoring_historyView refactoring audit trail

View refactoring audit trail

No parameter schema in public metadata yet.

cleanup_old_backupsClean up old backup files

Clean up old backup files

No parameter schema in public metadata yet.

generate_quality_reportComprehensive dashboard in HTML/Markdown/JSON

Comprehensive dashboard in HTML/Markdown/JSON

No parameter schema in public metadata yet.

Sponsors

Readme

OHM-MCP

OHM-MCP

AI-Powered Python Refactoring & Code Quality Assistant

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

MCP Registry Python 3.8+ MCP AST-Based License


✨ Core Capabilities


View the full README on GitHub

Details

Repository
github.com/murugarajr/ohm-mcp
Package
ohm-mcp
Transport
STDIO
Registry
MCP registry, active