MCP Safe Local Python Executor

🚀 安全本地Python執行器

安全本地Python執行器是一個使用MCP協議（stdio傳輸）封裝Hugging Face的LocalPythonExecutor（來自 smolagents 框架）的服務器。它作為一個自定義的Python運行時，在本地運行由大語言模型（LLM）生成的代碼時，能提供基本隔離和安全性，且無需Docker或虛擬機。此包允許通過MCP（模型上下文協議）將Python執行器作為工具暴露給LLM應用程序，像Claude Desktop、Cursor或其他任何與MCP兼容的客戶端都能使用。對於Claude Desktop而言，這是添加缺失的代碼解釋器（ChatGPT中早已具備）的簡單方法。

🚀 快速開始

安裝與運行

1. 安裝uv（例如，macOS上使用brew install uv或參考官方文檔）。
2. 克隆倉庫，進入目錄cd mcp_safe_local_python_executor。
3. 通過命令行運行服務器uv run mcp_server.py，此時會自動創建虛擬環境，並安裝依賴項（smollagents、mcp）。

配置Claude Desktop

要使用此MCP服務器，請按照以下步驟配置Claude Desktop：

1. 打開Claude Desktop的設置。
2. 在“實驗”部分啟用“自定義MCP服務器”。
3. 將MCP_SERVER_ADDRESS設置為http://localhost:5000。
4. 啟動Claude Desktop。

✨ 主要特性

• 提供run_python工具。
• 比直接使用Python的eval()更安全地執行代碼。
• 通過uv在Python虛擬環境中運行。
• 不允許任何文件I/O操作。
• 受限的導入列表：
  • collections
  • datetime
  • itertools
  • math
  • queue
  • random
  • re
  • stat
  • statistics
  • time
  • unicodedata

🔧 技術細節

安全性

需小心處理在你機器上運行由LLM生成的代碼，要遠離通過命令行或使用eval()運行Python的MCP服務器。最安全的選擇是使用VM或Docker容器，儘管這需要一些設置工作量也更大。有第三方服務提供Python運行時，但它們需要註冊和API密鑰等。

LocalPythonExecutor在直接使用本地Python環境（更易於設置）和遠程執行在Docker容器、虛擬機/第三方服務（更安全）之間提供了良好的平衡。Hugging Face團隊花費了大量時間從頭開始構建了一個更安全的本地Python執行器，用於其代碼代理：

為了增加第一層安全性，smolagents中代碼的執行並不是使用原始的Python解釋器。我們從頭開始重新構建了一個更安全的LocalPythonExecutor。

瞭解更多此處。

📦 安裝指南

1. 安裝uv（例如，macOS上使用brew install uv或參考官方文檔）。
2. 克隆倉庫，進入目錄cd mcp_safe_local_python_executor。
3. 通過命令行運行服務器uv run mcp_server.py，會自動創建虛擬環境，安裝依賴項（smollagents、mcp）。

💻 使用示例

基礎用法

# 安裝必要的依賴項
pip install uvicorn fastapi

# 創建一個名為mcp_server.py的新文件，並添加以下內容：
from fastapi import FastAPI
from fastapi.staticfiles import StaticFiles

app = FastAPI()
static_files = StaticFiles(directory=".")
app.mount("/static", static_files)

@app.get("/")
async def root():
    return {"message": "MCP服務器已啟動"}

運行腳本

uvicorn mcp_server:app --reload

運行上述腳本後，訪問http://localhost:5000即可測試你的MCP服務器。