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

贡献

欢迎贡献！请随意提交 Pull Request。以下是你可以贡献的一些方式：

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

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

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

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