Python 重构助手 MCP 服务器

镜像概述和主要用途

教育性的Python重构助手，为AI助手提供指导性建议。通过专业工具分析代码，提供逐步重构指导，帮助开发者学***重构模式，同时保持对代码更改的完全控制。它充当重构导师而非自动代码修改器，适合希望掌握重构技巧的开发者使用。

什么是MCP服务器？

核心功能和特性

提供逐步重构指导，不直接修改代码
使用专业工具（Rope、Radon、Vulture、Jedi、LibCST、Pyrefly）进行全面代码分析
采用教育式方法，通过引导练***教授重构模式
支持仅指导模式和应用更改模式
识别长函数、高复杂度代码、死代码和类型问题
提供精确的行号和具体的重构说明
兼容所有AI助手（Claude、GPT、Cursor、Continue等）

使用场景和适用范围

开发者学***重构模式和最佳实践
需要保持代码更改完全控制的重构过程
与AI助手配合使用，获取结构化的重构指导
代码质量提升和技术债务优化
Python项目的代码分析和改进

镜像特性

属性	详情
Docker镜像	mcp/mcp-python-refactoring
作者	slamer59
代码仓库	[***]
Dockerfile	[***]
Docker镜像构建方	Docker Inc.
Docker Scout健康评分	!Docker Scout Health Score
验证签名	`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/mcp-python-refactoring --key [***]`
许可证	MIT License

可用工具（9个）

工具	简短描述
`analyze_python_file`	分析Python文件以寻找重构机会并提供精确指导
`analyze_python_package`	全面的包/文件夹分析，寻找重构机会
`analyze_security_and_patterns`	全面的安全扫描和现代Python模式分析
`analyze_test_coverage`	分析Python测试覆盖率并提供改进建议
`find_long_functions`	查找适合提取的长函数
`find_package_issues`	识别包级别的重构机会和结构问题
`get_extraction_guidance`	获取详细的函数提取逐步指导
`get_package_metrics`	获取Python包的聚合指标
`tdd_refactoring_guidance`	生成基于TDD的重构指导：先测试，再重构，再测试

工具详情

工具：`analyze_python_file`

分析Python文件以寻找重构机会并提供精确指导

参数	类型	描述
`content`	`string`	待分析的Python文件内容
`file_path`	`string` 可选	待分析的Python文件路径

工具：`analyze_python_package`

全面的包/文件夹分析，寻找重构机会

参数	类型	描述
`package_path`	`string`	待分析的Python包/文件夹路径
`package_name`	`string` 可选	包名称（可选，将从路径推断）

工具：`analyze_security_and_patterns`

全面的安全扫描和现代Python模式分析

参数	类型	描述
`content`	`string`	待分析的Python文件内容
`file_path`	`string` 可选	待分析的Python文件路径
`include_dependency_scan`	`boolean` 可选	包含依赖项漏洞扫描（默认：true）
`include_modernization`	`boolean` 可选	包含现代Python模式建议（默认：true）
`include_security_scan`	`boolean` 可选	包含代码安全漏洞扫描（默认：true）

工具：`analyze_test_coverage`

分析Python测试覆盖率并提供改进建议

参数	类型	描述
`source_path`	`string`	源代码目录或文件路径
`target_coverage`	`integer` 可选	目标覆盖率百分比（默认：80）
`test_path`	`string` 可选	测试目录路径（可选）

工具：`find_long_functions`

查找适合提取的长函数

参数	类型	描述
`content`	`string`	待分析的Python文件内容
`line_threshold`	`integer` 可选	判定为长函数的最小行数（默认：20）

工具：`find_package_issues`

识别包级别的重构机会和结构问题

参数	类型	描述
`package_path`	`string`	Python包/文件夹路径
`issue_types`	`array` 可选	要查找的特定问题类型（可选）：scattered_functionality、god_package、circular_dependency等

工具：`get_extraction_guidance`

获取详细的函数提取逐步指导

参数	类型	描述
`content`	`string`	Python文件内容
`file_path`	`string` 可选	Python文件路径
`function_name`	`string` 可选	要分析提取的函数名称

工具：`get_package_metrics`

获取Python包的聚合指标

参数	类型	描述
`package_path`	`string`	Python包/文件夹路径
`package_name`	`string` 可选	包名称（可选）

工具：`tdd_refactoring_guidance`

生成基于TDD的重构指导：先测试，再重构，再测试

参数	类型	描述
`content`	`string`	待重构的Python代码内容
`function_name`	`string` 可选	要重构的特定函数/类（可选）
`test_path`	`string` 可选	测试目录路径（可选）

使用此MCP服务器

json
{
  "mcpServers": {
    "mcp-python-refactoring": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/mcp-python-refactoring"
      ]
    }
  }
}

为什么使用Docker运行MCP服务器更安全？

查看更多 mcp-python-refactoring 相关镜像 →