MCP Python Interpreter

Runs Python code and manages Python environments and packages from an agent, inside a working folder.

📊 Data & notebooks104Updated 2026-07-02By yzflyAuth: NoneGitHub ↗

Found viaWebPyPI: mcp-python-interpreter GitHubGitHub: yzfly/mcp-python-interpreter (★ 104 on 2026-10-15)

Test results

No full client pass yet

Claude CodeFailed2026-10-15 · connected, agent task (no successful call to this server's tools; no tool result containing ['42'])

CursorFailed2026-10-15 · connected, tools visible, agent task (no successful call to this server's tools; answer missing ['42']; no tool result containing ['42'])

Claude DesktopNot tested yet—

ChatGPT (Codex)Not tested yet—

Full result per app: Does it work with Claude Code? · Does it work with Cursor?

Protocol: failed · 2026-10-15 · server exited code 1

🧪 Test-box note: Published uvx snippet fails to start on Oct 15, 2026 (dependency break, see results/protocol). Tested as published; no pinning.

Install

claude mcp add mcp-python-interpreter -- uvx mcp-python-interpreter --dir /path/to/dir/pyinterp

Run in your terminal. This exact command is what our harness runs in Claude Code; see the results above.

{
  "mcpServers": {
    "mcp-python-interpreter": {
      "command": "uvx",
      "args": [
        "mcp-python-interpreter",
        "--dir",
        "/path/to/dir/pyinterp"
      ]
    }
  }
}

Save as .cursor/mcp.json. This exact config is what our harness runs in Cursor; see the results above.

{
  "mcpServers": {
    "mcp-python-interpreter": {
      "command": "uvx",
      "args": [
        "mcp-python-interpreter",
        "--dir",
        "/path/to/dir/pyinterp"
      ]
    }
  }
}

Add to claude_desktop_config.json and restart Claude Desktop. Tested on the Linux beta; see the results above.

[mcp_servers.mcp-python-interpreter]
command = "uvx"
args = ["mcp-python-interpreter", "--dir", "/path/to/dir/pyinterp"]

Add to ~/.codex/config.toml (shared by the ChatGPT (Codex) CLI and the ChatGPT desktop app; Codex runs inside the ChatGPT desktop app). Tested with the ChatGPT (Codex) CLI bundled in the ChatGPT desktop app; see the results above.

Not connecting? Troubleshooting: Claude Code · Cursor · Claude Desktop · ChatGPT (Codex)

Test history

Date	Check	Result	Version
2026-10-15	Protocol (direct stdio)	Protocol: failed
2026-10-15	Claude Code	Failed connected, agent task (no successful call to this server's tools; no tool result containing ['42'])	2.1.296 (Claude Code)
2026-10-15	Cursor	Failed connected, tools visible, agent task (no successful call to this server's tools; answer missing ['42']; no tool result containing ['42'])	2026.10.14-941492e