Python REPL服务器

提供基于MCP协议的Python代码执行服务,支持持久化会话和包管理功能。

  • by hdresearch
  • Python
  • 本地部署
  • 43 星标
  • 更新于
在 GitHub 查看 hdresearch/mcp-python

使用说明

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}")

列出所有变量:

# Use the list_variables tool

重置会话:

# Use execute_python with reset=true

贡献

欢迎投稿!请随时提交拉取请求。以下是您可以做出贡献的一些方式:

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

在提交PR之前,请确保:

  1. 您的代码遵循现有样式
  2. 您已根据需要更新了文档
  3. 也许写一些测试?

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