Provides access to the rope-mcp source code repository for installation and contribution to the project's development.
Enables installation of the rope-mcp package directly from the Python Package Index when released.
Exposes Python Rope refactoring library capabilities to users, enabling symbol renaming, method extraction, code analysis, and object information retrieval for Python codebases.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Rope MCPrename the calculate_total function to compute_total in utils.py"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
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.