基本能力
产品定位
MCP Python Interpreter 是一个开发工具，旨在通过 MCP 协议为 LLMs 提供 Python 环境的交互能力，支持代码执行、文件操作和环境管理。
核心功能
- 环境管理：列出和使用不同的 Python 环境（系统和 conda）。
- 代码执行：在任何可用的 Python 环境中运行 Python 代码或脚本。
- 包管理：列出已安装的包并安装新包。
- 文件操作：
- 读取任何类型的文件（文本、源代码、二进制）。
- 写入文本和二进制文件。
- Python 提示：提供常见 Python 任务的模板，如函数创建和调试。
适用场景
- 开发者在本地 Python 环境中执行代码或脚本。
- 管理 Python 环境和包依赖。
- 读取和写入文件内容，支持文本和二进制文件。
- 使用预定义的 Python 模板快速生成代码或调试错误。
工具列表
- 环境与包管理：
list_python_environments：列出所有可用的 Python 环境。list_installed_packages：列出特定环境中安装的包。install_package：在特定环境中安装 Python 包。- 代码执行：
run_python_code：在特定环境中执行 Python 代码。run_python_file：在特定环境中执行 Python 文件。- 文件操作：
read_file：读取任何文件类型的内容。write_file：创建或覆盖文件（文本或二进制）。write_python_file：创建或覆盖 Python 文件。list_directory：列出目录中的 Python 文件。
常见问题解答
- 安全性：服务严格限制文件操作范围，仅允许在指定工作目录内进行读写，防止越权访问。
- 文件大小限制：支持读取的文件大小上限为 1MB。
- 覆盖保护：写入文件时需要明确指定是否覆盖现有文件。
使用教程
使用依赖
安装 uv 工具（如果未安装）：
bash
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows 用户：
powershell
powershell -ExecutionPolicy Bypass -Command "iwr -useb https://astral.sh/uv/install.ps1 | iex"
安装教程
使用 pip 安装：
bash
pip install mcp-python-interpreter
或使用 uv 安装：
bash
uv install mcp-python-interpreter
调试方式
- 安装 Claude Desktop。
- 打开 Claude Desktop，进入菜单 > 设置 > 开发者选项卡，点击“编辑配置”。
- 在
claude_desktop_config.json中添加以下配置：
json
{
"mcpServers": {
"mcp-python-interpreter": {
"command": "uvx",
"args": [
"mcp-python-interpreter",
"--dir",
"/path/to/your/work/dir",
"--python-path",
"/path/to/your/python"
],
"env": {
"MCP_ALLOW_SYSTEM_ACCESS": 0
}
}
}
} - 重启 Claude Desktop，即可在聊天界面看到 MCP 工具图标。
注意：--dir 参数是必需的，用于指定文件操作的工作目录。
