Python MCP Server

🚀 Python MCP 服務器

Python MCP 服務器是一個用於執行 Python 代碼並管理 Python 環境的模型上下文協議 (MCP) 服務器。它允許 Claude 和其他大語言模型運行 Python 代碼、管理文件，並與 Python 包進行交互，為大語言模型與 Python 環境的交互提供了便利。

🚀 快速開始

Python MCP 服務器為大語言模型提供了與 Python 環境交互的能力。在使用前，需要完成一系列準備工作，包括安裝先決條件、克隆倉庫、安裝依賴、構建項目以及進行相應配置。

✨ 主要特性

• 代碼執行：可運行 Python 代碼片段或執行 Python 文件。
• 文件管理：支持列出、讀取和寫入 Python 文件。
• Python 環境：能檢查 Python 版本和環境信息。
• 可配置執行：可設置超時時間、工作目錄和命令行參數。

📦 安裝指南

克隆倉庫

git clone https://github.com/Timtech4u/python-mcp-server.git
cd python-mcp-server

安裝依賴

npm install

構建項目

npm run build

📚 詳細文檔

配置說明

針對 Claude Desktop 的配置

1. 打開 config.json 文件。
2. 添加以下內容：

   {
     "pythonPath": "C:/Python39/python.exe",
     "nodeModulesDir": "node_modules"
   }
   

3. 保存文件。

針對 Cline 的配置

1. 打開終端，運行命令：

   mcp-config set pythonPath=C:\Python39\python.exe
   

使用方法

示例對話

執行代碼

{
  "command": "execute_python_code",
  "params": {
    "code": "print('Hello, World!')",
    "timeout": 30
  }
}

響應：

{
  "output": "Hello, World!\n"
}

執行文件

{
  "command": "execute_python_file",
  "params": {
    "filePath": "./script.py",
    "args": ["arg1", "arg2"]
  }
}

可用工具

執行 Python 代碼

• 參數：
  • code（字符串，必填）：要執行的 Python 代碼。
  • timeout（數字，可選）：超時時間，默認為 30 秒。

執行 Python 文件

• 參數：
  • filePath（字符串，必填）：要執行的 Python 文件路徑。
  • args（數組，可選）：傳遞給腳本的命令行參數。

故障排除

找不到 Python

如果出現“Python 沒有安裝”的錯誤，請確保 Python 已正確安裝並添加到系統 PATH 環境變量中。

權限問題

如果遇到權限錯誤，檢查 MCP 服務器運行用戶是否有足夠的文件訪問權限。

超時問題

默認超時時間為 30 秒。如需延長，請在請求中指定 timeout 參數。

📄 許可證

MIT