Python REPL MCP Server

🚀 Python REPL MCP 服務器

本 MCP 服務器提供了 Python REPL（讀取 - 評估 - 打印循環）工具，可藉助 MCP 協議執行具備持久會話的 Python 代碼。

🚀 快速開始

安裝

無需安裝！該項目使用 uv 進行依賴管理。

運行服務器

簡單運行以下命令即可啟動服務器：

uv run src/python_repl/server.py

與 Claude Desktop 配合使用

將以下配置添加到你的 Claude Desktop 配置文件中：

{
  "mcpServers": {
    "python-repl": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/python-repl-server",
        "run",
        "mcp_python"
      ]
    }
  }
}

✨ 主要特性

服務器提供了三個實用工具：

1. execute_python：執行帶有持久變量的 Python 代碼
   • code：待執行的 Python 代碼
   • reset：可選的布爾值，用於重置會話
2. list_variables：顯示當前會話中的所有變量
3. install_package：從 pypi 安裝包

💻 使用示例

基礎用法

設置一個變量

a = 42

使用該變量

print(f"The value is {a}")

高級用法

列出所有變量

# 使用 list_variables 工具

重置會話

# 使用 execute_python 並將 reset 設置為 true

🤝 貢獻

歡迎大家參與項目貢獻！你可以通過以下方式進行貢獻：

• 報告錯誤
• 建議新功能
• 改進文檔
• 添加測試用例
• 提交代碼改進

在提交 PR 之前，請確保做到以下幾點：

1. 你的代碼遵循現有風格。
2. 你已更新所需的文檔。
3. 如有可能，為測試編寫一些代碼。

對於重大更改，請先打開一個問題來討論你想更改的內容。