Rope MCP

A Model Context Protocol (MCP) server with companion CLI that exposes Python Rope refactoring library capabilities to Claude Code and command-line users.

Features

• Dual Interface: Both MCP server for Claude Code integration and CLI for direct use

• Safe Refactoring: Symbol renaming and method extraction with built-in safety checks

• Code Analysis: Symbol definition finding, reference tracking, and object information

• Backup System: Automatic file backups with easy restore capabilities

• Shared Core: Identical functionality across MCP and CLI interfaces

Related MCP server: MCP Python Toolbox

Quick Start

Installation

# Install from PyPI (when released)
pip install rope-mcp

# Or install from source
git clone https://github.com/brukhabtu/rope-mcp.git
cd rope-mcp
pip install -e .

CLI Usage

# Initialize project
rope-mcp init-project

# Analyze a symbol
rope-mcp analyze-symbol --file src/utils.py --line 23 --column 4

# Rename a symbol (with preview)
rope-mcp rename-symbol --file src/utils.py --line 23 --column 4 --new-name "better_name" --dry-run
rope-mcp rename-symbol --file src/utils.py --line 23 --column 4 --new-name "better_name"

# Extract method
rope-mcp extract-method --file src/utils.py --start-line 45 --end-line 67 --method-name "validate_input"

Claude Code Integration

Add to your Claude Code MCP configuration:

{
  "mcpServers": {
    "rope": {
      "command": "rope-mcp-server",
      "args": [],
      "env": {}
    }
  }
}

Documentation

• CLI Reference

• MCP Tool Reference

• Claude Code Integration Guide

• Project Plan

Development Status

🚧 In Development - See PROJECT_PLAN.md for roadmap and current status.

Contributing

See the Implementation Roadmap for development phases and contributing guidelines.

License

MIT License - see LICENSE for details.