关于 python_local MCP Server
python_local 是一个 MCP 服务,提供在本地运行的交互式 Python REPL 环境。它按会话保存状态,并通过 repl:// 资源查看每个会话的执行历史。
主要功能
- 01交互式 Python REPL 环境
- 02按 session_id 隔离的持久会话状态
- 03支持表达式与语句执行
- 04捕获 stdout 和 stderr 输出
- 05通过 repl:// 资源查看会话历史
适用场景
- 01在对话中逐步执行并验证 Python 代码
- 02保留多步计算的中间变量与状态
- 03回溯查看此前会话的输入与输出
MCP 相关
该服务通过 stdio 运行,向 MCP 客户端暴露一个 python_repl 工具和基于 repl:// 的会话历史资源。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
python_local MCP 服务
一个提供交互式 Python REPL(读取-求值-打印循环)环境的 MCP 服务。
组件
资源
该服务提供对 REPL 会话历史记录的访问:
- 用于访问会话历史记录的自定义
repl://URI 方案 - 每个会话的历史记录都可以作为 text/plain 资源查看
- 历史记录会显示每次执行的输入代码及相应输出
工具
该服务实现了一个工具:
python_repl:在持久会话中执行 Python 代码- 必需参数为
code(要执行的 Python 代码)和session_id - 为每个会话维护独立状态
- 支持表达式和语句
- 捕获并返回 stdout/stderr 输出
- 必需参数为
配置
安装
Claude Desktop
MacOS:~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows:%APPDATA%/Claude/claude_desktop_config.json
开发版/未发布服务配置
```json "mcpServers": { "python_local": { "command": "uv", "args": [ "--directory", "/path/to/python_local", "run", "python_local" ] } } ```已发布服务配置
```json "mcpServers": { "python_local": { "command": "uvx", "args": [ "python_local" ] } } ```开发
构建和发布
准备分发软件包:
- 同步依赖项并更新锁文件:
uv sync
- 构建软件包分发文件:
uv build
这将在 dist/ 目录中创建源代码分发包和 wheel 分发包。
- 发布到 PyPI:
uv publish
注意:你需要通过环境变量或命令行标志设置 PyPI 凭据:
- 令牌:
--token或UV_PUBLISH_TOKEN - 或用户名/密码:
--username/UV_PUBLISH_USERNAME和--password/UV_PUBLISH_PASSWORD
调试
由于 MCP 服务通过 stdio 运行,调试可能颇具挑战。为了获得最佳调试体验,我们强烈建议使用 MCP Inspector。
你可以通过 npm 使用以下命令启动 MCP Inspector:
npx @modelcontextprotocol/inspector uv --directory /path/to/python_local run python-local
启动后,Inspector 会显示一个 URL,你可以在浏览器中访问该 URL 开始调试。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。