Python REPL MCP Server

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Allows installation of Python packages directly from PyPI using the install_package tool, enabling access to additional Python libraries as needed.

  • Offers a persistent Python execution environment that maintains variable state between code executions, enabling multi-step programming workflows.

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

贡献

欢迎贡献代码!欢迎提交 Pull 请求。以下是一些您可以贡献代码的方式:

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

在提交 PR 之前,请确保:

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

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

通过 MCP 协议提供持久 Python REPL 环境的服务器,允许执行 Python 代码、变量管理和包安装。

  1. Setup
    1. Running the Server
      1. Usage with Claude Desktop
        1. Examples
          1. Contributing
            ID: jsorljnhdl