Terminal Controller MCP

🚀 終端控制器 for MCP

終端控制器 for MCP 是一個模型上下文協議（MCP）服務器，它藉助標準接口實現了安全的終端命令執行、目錄導航以及文件系統操作，為用戶提供便捷高效的終端控制體驗。

🚀 快速開始

終端控制器 for MCP 可通過多種方式安裝並使用，以下為你詳細介紹。

✨ 主要特性

• 命令執行：帶超時控制的終端命令運行，全面結果反饋。可運行系統命令，獲取即時輸出和結果。
• 目錄導航：輕鬆瀏覽和操作文件系統結構，能瀏覽目錄結構，執行基本的文件管理操作。
• 文件系統操作：對文件和目錄進行高效管理，涵蓋讀取、寫入、插入、更新和刪除等功能。
• 安全機制：內置黑名單機制，防止危險命令執行。

📦 安裝指南

通過 Smithery 安裝

# 安裝 Terminal Controller for MCP
# 配置 MCP 環境
# 啟動服務

使用 Python 包安裝

pip install terminal-controller-mcp

📚 詳細文檔

客戶端配置

MCP 客戶端配置示例

# 示例配置文件
{
    "server_address": "localhost",
    "port": 5000,
    "timeout": 3600
}

使用說明

命令行使用示例

# 運行終端控制器服務
python -m terminal_controller

# 或者使用 uvx 工具：
uvx terminal_controller

安全注意事項

• 所有命令執行都有超時控制，默認為3600秒。
• 禁止使用危險命令如 rm -rf /、format 和 mkfs。
• 操作結果會被詳細記錄和審計。

限制與不足

• 命令僅在超時時間內返回結果。
• 默認情況下，服務器擁有與當前用戶相同的文件系統權限。
• 部分交互式命令可能無法正常工作，因為它們依賴於交互界面。

故障排除

1. 確保 Python 版本為 3.11 或更高。
2. 檢查 MCP 客戶端配置是否正確。
3. 直接運行終端控制器檢查是否有錯誤：

   python -m terminal_controller
   

4. 對於 uvx 相關問題，嘗試：

   uvx terminal_controller
   

🤝 貢獻

歡迎貢獻！請隨意提交 Pull Request。

📄 許可證

MIT