python_local MCP Server

简介

Python Local 是一个 MCP 服务器，提供交互式 Python REPL 环境，允许您在持久会话中执行 Python 代码。

安装与配置

使用 Claude 桌面版

1. 根据您的操作系统，编辑配置文件：

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json

2. 添加服务器配置：

   已发布版本:

   "mcpServers": {
     "python_local": {
       "command": "uvx",
       "args": ["python_local"]
     }
   }
   

   开发版本:

   "mcpServers": {
     "python_local": {
       "command": "uv",
       "args": [
         "--directory",
         "/path/to/python_local",
         "run",
         "python_local"
       ]
     }
   }
   

使用方法

执行 Python 代码

使用 python_repl 工具运行 Python 代码，指定 code 和 session_id 参数：

// 执行一个简单的计算
print(2 + 2)

// 定义变量和函数
x = 10
def square(n):
    return n * n
print(square(x))

// 使用第三方库
import numpy as np
arr = np.array([1, 2, 3])
print(arr.mean())

查看会话历史

您可以通过自定义 repl:// URI 方案访问会话历史，历史记录包含所有执行的代码及其输出。

开发

构建与发布

1. 同步依赖项：uv sync
2. 构建分发包：uv build
3. 发布到 PyPI：uv publish (需要设置 PyPI 凭证)

调试

使用 MCP Inspector 进行调试：

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

访问浏览器中显示的 URL 开始调试。