使用说明

项目简介

Python REPL Server 是一个基于 Python 开发的 MCP 服务器，旨在通过集成 REPL (Read-Eval-Print Loop) 工具来增强 Claude 等大型语言模型的功能。该服务器提供了一系列工具，允许 Claude 执行 Python 代码、运行 shell 命令以及使用 Perl 脚本进行文件操作，从而扩展了 Claude 的能力边界，使其能够处理更复杂的任务。

主要功能点

Python 代码执行：
- 一次性 Python 执行 ('python')：在隔离的环境中执行 Python 代码片段，适用于快速计算、数据处理和测试，每次执行环境都是全新的。
- 会话式 Python 执行 ('python_session')：在持久会话中执行 Python 代码，保持变量和状态，适用于数据分析、多步骤计算等需要保持上下文的任务，会话在 5 分钟不活动后过期。
Shell 命令执行：
- 命令执行 ('shell')：允许 Claude 执行 shell 命令，快速命令立即返回结果，长时间运行的命令切换到异步模式并返回任务 ID。
- 任务状态查询 ('shell_status')：用于查询异步 shell 命令的执行状态，包括进度、输出和返回值，可以监控长时间运行的 shell 任务。
文件操作：
- 文件修改 ('perl')：使用 Perl 脚本安全地修改文件内容，支持基于模式的查找和替换、多行转换，并默认处理 UTF-8 编码，适用于需要对文件进行文本处理的场景。

安装步骤

克隆仓库

git clone https://github.com/lyuhau/claude-mcp-repl
cd claude-mcp-repl

安装依赖 根据你的 Python 包管理工具选择以下命令之一安装项目依赖：

使用 Poetry:
```
poetry install
```

使用 uv pip:

uv pip install -r pyproject.toml

服务器配置

要将此 MCP 服务器与 Claude Desktop 客户端连接，你需要在 Claude 的配置文件中添加服务器配置信息。配置信息为 JSON 格式，你需要指定服务器的名称、启动命令和参数。

打开 Claude Desktop 的配置文件 'claude_desktop_config.json' (不同操作系统的配置文件路径请参考仓库的 'README.md' 或 'INSTALLATION.md' 文件)，在 'mcpServers' 字段下添加 'repl' 服务器的配置：

{
  "mcpServers": {
    "repl": {
      "command": "/path/to/python/env/bin/python",
      "args": ["-m", "repl"]
    }
  }
}

配置参数说明：

'server name': 'repl' (服务器名称，在 Claude 配置文件中用于标识该服务器，可以自定义)
'command': '/path/to/python/env/bin/python' (Python 解释器路径，请务必替换为你的 Python 虚拟环境或 Python 解释器的实际路径。你需要确保 Claude 客户端能够访问到这个 Python 解释器)
'args': '["-m", "repl"]' (启动服务器的参数。 '"-m repl"' 表示以模块方式运行 'repl' 包，这是启动 'Python REPL Server' 的标准方式，通常无需修改)

基本使用方法

启动服务器：完成配置后，当 Claude Desktop 启动时，它会根据配置文件尝试连接到你配置的 MCP 服务器。'Python REPL Server' 会在后台运行，并等待 Claude 客户端的请求。
在 Claude 中使用工具：在 Claude 的对话界面中，你可以指示 Claude 使用已注册的工具。例如，你可以要求 Claude 执行 Python 代码进行计算，或者运行 shell 命令来获取系统信息。Claude 会将你的请求发送到 'Python REPL Server'，服务器会调用相应的工具执行操作，并将结果返回给 Claude。
- 例如，在 Claude 中你可以这样提问：
  - "使用 python 工具计算 2 + 2 等于多少？"
  - "使用 shell 工具查看当前目录下的文件列表。"
  - "使用 perl 工具将文件 'example.txt' 中的 'apple' 替换为 'orange'。"

注意：确保你配置的 Python 解释器路径正确，并且安装了项目所需的依赖。Claude 客户端需要能够成功连接到 MCP 服务器才能使用这些扩展功能。

关键词