mcpField
P
python_local MCP Server

python_local MCP Server

本地服务
github.com/Alec2435开发工具5499 周前更新

关于 python_local MCP Server

python_local 是一个 MCP 服务,提供在本地运行的交互式 Python REPL 环境。它按会话保存状态,并通过 repl:// 资源查看每个会话的执行历史。

主要功能

  1. 01交互式 Python REPL 环境
  2. 02按 session_id 隔离的持久会话状态
  3. 03支持表达式与语句执行
  4. 04捕获 stdout 和 stderr 输出
  5. 05通过 repl:// 资源查看会话历史

适用场景

  1. 01在对话中逐步执行并验证 Python 代码
  2. 02保留多步计算的中间变量与状态
  3. 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" ] } } ```

开发

构建和发布

准备分发软件包:

  1. 同步依赖项并更新锁文件:
uv sync
  1. 构建软件包分发文件:
uv build

这将在 dist/ 目录中创建源代码分发包和 wheel 分发包。

  1. 发布到 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 开始调试。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。