Term MCP Deepseek

🚀 深度求索 MCP 類型終端服務器

本項目藉助 DeepSeek API 構建了一個類似 MCP 協議的服務器原型。其主要目的是展示 MCP 的核心概念，通過開放特定端點，讓 AI 助手能夠完成以下操作：

• 羅列可用工具
• 在活動的 Shell 會話中調用命令
• 集成一個 AI 聊天（深度求索），該聊天可包含特殊指令（如 CMD: 行）以觸發命令執行

⚠️ 重要提示

儘管此實現涵蓋了 MCP 的諸多核心概念，但它並非完全符合 Anthropic 所定義的 MCP 服務器。它是一個概念驗證設計，若要投入生產環境使用，還需進一步改進（如支持 JSON - RPC 協議、通過 SSE 實現即時更新、會話管理以及增強安全性等）。

✨ 主要特性

• 聊天界面：運用 Flask 和 Tailwind CSS 搭建的簡單 Web 聊天客戶端，方便用戶與服務器進行交互。
• AI 集成：利用深度求索 API 生成響應。AI 可通過包含以 CMD: 開頭的行，指示服務器執行終端命令。
• 終端命令執行：藉助 pexpect 庫維持一個持久的 Bash 會話，並將命令輸出返回給客戶端，以此執行 Shell 命令。
• MCP 端點：提供 /mcp/list_tools 和 /mcp/call_tool 端點，模擬 MCP 工具的發現和調用功能。

📦 安裝指南

先決條件

• Python 3.8 及以上版本
• pip
• 有效的深度求索 API 密鑰

安裝步驟

1. 克隆倉庫：

git clone https://github.com/OthmaneBlial/term_mcp_deepseek.git
cd term_mcp_deepseek

2. 創建並激活虛擬環境：

python3 -m venv venv
source venv/bin/activate  # 在 Windows 上，使用 `venv\Scripts\activate`

3. 安裝所需依賴項：

pip install -r requirements.txt

4. 配置 API 密鑰： 將 .env 文件中的 DEEPSEEK_API_KEY 更新為您的深度求索 API 密鑰。

🚀 快速開始

運行服務器

運行 Flask 服務器：

python server.py

通過訪問 http://127.0.0.1:5000 即可使用聊天界面。

📚 詳細文檔

端點說明

聊天端點

• URL：/chat
• 方法：POST
• 負載：{ "message": "您的消息內容" }
• 描述：將用戶消息添加到對話中，發送至深度求索 API，查找其中的命令指令（CMD:）並執行，最後返回最終響應。

MCP 端點

列出工具

• URL：/mcp/list_tools
• 方法：POST
• 響應：以 JSON 列表形式展示可用工具（如 write_to_terminal、read_terminal_output、send_control_character）。

調用工具

• URL：/mcp/call_tool
• 方法：POST
• 負載：

{
    "name": "tool_name",
    "arguments": { ... }
}

• 描述：調用指定工具並按需傳遞參數。

🔧 技術細節

未來改進方向

1. 協議標準化：實現對 JSON - RPC 協議的全面支持，確保與現有系統兼容。
2. 即時通信：集成 WebSocket 或 Server - Sent Events (SSE)，實現即時命令執行和輸出反饋。
3. 會話管理：添加用戶身份驗證和會話管理功能，支持多個客戶端同時連接。
4. 錯誤處理與日誌記錄：構建更強大的錯誤處理機制，集成日誌記錄功能，便於跟蹤服務器操作和調試問題。
5. 性能優化：優化服務器代碼和配置，提升命令執行速度和整體響應時間。