Python REPL MCP Server

🚀 Python REPL MCP 服务器

本 MCP 服务器提供了 Python REPL（读取 - 评估 - 打印循环）工具，可借助 MCP 协议执行具备持久会话的 Python 代码。

🚀 快速开始

安装

无需安装！该项目使用 uv 进行依赖管理。

运行服务器

简单运行以下命令即可启动服务器：

uv run src/python_repl/server.py

与 Claude Desktop 配合使用

将以下配置添加到你的 Claude Desktop 配置文件中：

{
  "mcpServers": {
    "python-repl": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/python-repl-server",
        "run",
        "mcp_python"
      ]
    }
  }
}

✨ 主要特性

服务器提供了三个实用工具：

1. execute_python：执行带有持久变量的 Python 代码
   • code：待执行的 Python 代码
   • reset：可选的布尔值，用于重置会话
2. list_variables：显示当前会话中的所有变量
3. install_package：从 pypi 安装包

💻 使用示例

基础用法

设置一个变量

a = 42

使用该变量

print(f"The value is {a}")

高级用法

列出所有变量

# 使用 list_variables 工具

重置会话

# 使用 execute_python 并将 reset 设置为 true

🤝 贡献

欢迎大家参与项目贡献！你可以通过以下方式进行贡献：

• 报告错误
• 建议新功能
• 改进文档
• 添加测试用例
• 提交代码改进

在提交 PR 之前，请确保做到以下几点：

1. 你的代码遵循现有风格。
2. 你已更新所需的文档。
3. 如有可能，为测试编写一些代码。

对于重大更改，请先打开一个问题来讨论你想更改的内容。