Claude REPL Server

基本能力

产品定位

Claude REPL Server 是一个功能增强工具，旨在为 Claude 提供代码执行、命令运行和文件操作的能力，从而扩展 Claude 的功能范围和应用场景。

核心功能

1. Python 工具
2. 一次性 Python (python): 在全新的环境中运行代码，适合快速计算和测试，支持 Pandas 和 PyArrow，每次执行都会清理环境。

3. 会话式 Python (python_session): 运行代码并保持持久状态，适合数据分析工作流，会话保持活跃状态 5 分钟。

4. Shell 工具

5. 命令执行 (shell): 运行 Shell 命令，快速命令立即返回，长时间运行的命令切换到异步模式，返回任务 ID 以便跟踪。

6. 任务状态 (shell_status): 监控长时间运行的命令，检查异步命令的进度，获取执行结果和运行时间。

7. 文件工具

8. 文件修改 (perl): 安全的文本处理工具，支持基于模式的搜索和替换、多行转换、UTF-8 编码，并保留文件结构。

适用场景

• 数据分析: 使用 python_session 进行持久化数据分析。
• 快速计算: 使用 python 进行一次性计算和测试。
• 自动化任务: 使用 shell 和 shell_status 运行和监控命令。
• 文件处理: 使用 perl 工具进行文件内容的搜索、替换和转换。

工具列表

1. Python 工具: 提供代码执行环境，支持一次性或持久化运行。
2. Shell 工具: 执行和监控 Shell 命令。
3. 文件工具: 安全地修改和处理文件内容。

常见问题解答

• 如何安装依赖？ 使用 poetry install 或 uv pip install -r pyproject.toml 安装依赖。
• 如何配置？ 在 Claude Desktop 配置文件中添加 mcpServers 部分，指定 Python 环境和模块路径。

使用教程

使用依赖

1. 确保已安装 Python 和 Poetry 或 uv。
2. 运行以下命令安装依赖： bash poetry install 或 bash uv pip install -r pyproject.toml

安装教程

1. 克隆仓库。
2. 安装依赖（如上所述）。
3. 在 Claude Desktop 配置文件中添加以下内容： json { "mcpServers": { "repl": { "command": "/path/to/python/env/bin/python", "args": ["-m", "repl"] } } }

调试方式

1. 启动服务后，使用 python 或 python_session 运行代码测试功能。
2. 使用 shell 运行命令并检查输出。
3. 使用 shell_status 监控长时间运行的任务。
4. 使用 perl 工具测试文件修改功能。

许可证

None