Python本地MCP服务器

一个提供交互式Python REPL（读取-求值-打印循环）环境的MCP服务器。

组件

资源

服务器提供对REPL会话历史的访问：

• 自定义repl:// URI方案用于访问会话历史
• 每个会话的历史可以以text/plain资源的形式查看
• 历史记录显示每次执行的输入代码和相应的输出

工具

服务器实现了一个工具：

• python_repl：在持久会话中执行Python代码
  • 需要code（要执行的Python代码）和session_id作为必需参数
  • 为每个会话维护独立的状态
  • 支持表达式和语句
  • 捕获并返回stdout/stderr输出

配置

安装

Claude桌面版

在MacOS上：~/Library/Application\ Support/Claude/claude_desktop_config.json
在Windows上：%APPDATA%/Claude/claude_desktop_config.json

开发

构建和发布

为分发准备包：

1. 同步依赖项并更新锁文件：

uv sync

2. 构建包分发：

uv build

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

3. 发布到PyPI：

uv publish

注意：您需要通过环境变量或命令行标志设置PyPI凭据：

• 令牌：--token或UV_PUBLISH_TOKEN
• 或用户名/密码：--username/UV_PUBLISH_USERNAME和--password/UV_PUBLISH_PASSWORD

调试

由于MCP服务器通过stdio运行，调试可能具有挑战性。为了获得最佳的调试体验，我们强烈推荐使用MCP检查器。

您可以通过npm启动MCP检查器，使用以下命令：

npx @modelcontextprotocol/inspector uv --directory /path/to/python_local run python-local

启动后，检查器将显示一个URL，您可以在浏览器中访问该URL以开始调试。