MCP Python Toolbox

基本能力

产品定位

MCP Python Toolbox 是一个为 AI 助手设计的 Python 开发工具集，通过标准化的接口提供 Python 开发所需的各种功能。

核心功能

1. 文件操作 (FileOperations)
2. 在指定工作区内进行安全的文件操作
3. 路径验证以防止越权访问
4. 支持文件和目录的创建、删除、读写

5. 列出目录内容并获取详细元数据

6. 代码分析 (CodeAnalyzer)

7. 使用 AST 解析和分析 Python 代码结构
8. 提取导入语句、函数定义、类定义等信息
9. 支持代码格式化（Black 或 PEP8）

10. 使用 Pylint 进行代码检查

11. 项目管理 (ProjectManager)

12. 创建和管理虚拟环境
13. 灵活的依赖管理（支持 requirements.txt 和 pyproject.toml）
14. 检查依赖冲突

15. 生成 requirements.txt

16. 代码执行 (CodeExecutor)

17. 在受控环境中执行 Python 代码
18. 捕获标准输出、错误输出和退出码
19. 支持自定义工作目录

适用场景

• AI 助手辅助 Python 开发
• 自动化代码分析和格式化
• 项目依赖管理
• 安全执行 Python 代码

工具列表

1. FileOperations：文件操作工具
2. CodeAnalyzer：代码分析工具
3. ProjectManager：项目管理工具
4. CodeExecutor：代码执行工具

常见问题解答

无明确常见问题解答部分

使用教程

使用依赖

1. Python 环境
2. Git（用于克隆仓库）

安装教程

1. 克隆仓库：

git clone https://github.com/gianlucamazza/mcp_python_toolbox.git
cd mcp_python_toolbox

1. 创建并激活虚拟环境：

python -m venv .venv
source .venv/bin/activate  # Linux/Mac
# 或
.venv\Scripts\activate  # Windows

1. 安装开发模式包：

pip install -e ".[dev]"

调试方式

1. 运行测试：

pytest

1. 类型检查：

mypy src/mcp_python_toolbox

1. 代码检查：

pylint src/mcp_python_toolbox

1. 代码格式化：

black src/mcp_python_toolbox

许可证

该项目遵循 MIT 开源许可条款。