Nash

🚀 Nash MCP 服務器

Nash MCP（模型上下文協議 (MCP) 服務器）實現了命令執行、Python 代碼運行、網絡內容獲取和任務管理的無縫集成，為用戶提供了高效便捷的操作體驗。

🚀 快速開始

Nash MCP 服務器能幫助你輕鬆實現命令執行、Python 代碼運行等功能。在開始使用前，請確保滿足以下安裝要求並完成安裝步驟。

📦 安裝指南

安裝要求

• Python 3.11+
• Poetry 包管理器（推薦）

安裝步驟

git clone https://github.com/nash-run/nash-mcp.git
cd nash-mcp
poetry install

✨ 主要特性

• 命令執行：運行 shell 命令並處理錯誤
• Python 執行：運行 Python 代碼並捕獲錯誤
• 安全憑證：存儲和訪問 API 密鑰，避免敏感數據洩露給大語言模型 (LLM)
• 網絡內容獲取：抓取並解析網頁內容進行分析
• 任務管理：保存和整理可複用的任務

📚 詳細文檔

環境變量配置

以下環境變量需在運行時指定：

使用說明

工具模塊

命令執行

execute_command(command: str) -> str

參數：command - 要運行的 shell 命令
返回值：命令輸出或錯誤信息

Python 執行

execute_python(code: str, file_name: str = "") -> str

參數：

• code: 待執行的 Python 代碼片段
• file_name (可選): 存放代碼文件的名稱，默認為空字符串

常見注意事項

⚠️ 重要提示

1. 所有 API 密鑰需通過環境變量加載，避免硬編碼。
2. 所有操作和工具執行的日誌均記錄在指定目錄下，便於後續排查問題。
3. 建議定期審查服務器代碼和配置文件，確保無未授權訪問風險。

開發指南

日誌系統

詳細的按時間戳記錄的操作日誌存儲於 NASH_LOGS_PATH 指定的目錄中，內容涵蓋所有操作及工具執行情況。

測試框架

poetry run pytest

帶代碼覆蓋率測試：

poetry run pytest --cov=nash_mcp

📄 許可證

本項目採用 MIT License 進行許可。