基本能力
产品定位
DeepSeek MCP-like Server for Terminal 是一个用于终端操作的AI集成服务器,旨在通过AI助手增强终端命令的执行和交互体验。
核心功能
- 聊天界面:基于Flask和Tailwind CSS的简单Web聊天客户端,用户可以通过该界面与服务器交互。
- AI集成:使用DeepSeek API生成响应,AI可以通过包含
CMD:
行的指令触发服务器执行终端命令。 - 终端命令执行:通过
pexpect
库在持久的Bash会话中执行shell命令,并将输出返回给客户端。 - MCP端点:提供
/mcp/list_tools
和/mcp/call_tool
端点,模拟MCP工具发现和调用。
适用场景
- 开发者在终端中需要AI辅助执行命令的场景。
- 需要自动化终端操作的开发流程。
- 概念验证或教育目的,展示AI与终端交互的可能性。
工具列表
- write_to_terminal:向终端写入内容。
- read_terminal_output:读取终端输出。
- send_control_character:发送控制字符。
常见问题解答
- Q: 是否需要DeepSeek API密钥?
A: 是的,需要在.env
文件中配置DEEPSEEK_API_KEY
。 - Q: 是否支持实时命令输出流?
A: 目前不支持,未来计划通过Server-Sent Events (SSE)或WebSockets实现。
使用教程
使用依赖
- Python 3.8+
- pip
- 有效的DeepSeek API密钥
安装教程
- 克隆仓库:
bash
git clone https://github.com/OthmaneBlial/term_mcp_deepseek.git
cd term_mcp_deepseek - 创建并激活虚拟环境:
bash
python3 -m venv venv
source venv/bin/activate # Windows用户使用`venv\Scripts\activate` - 安装依赖:
bash
pip install -r requirements.txt - 配置API密钥:
在.env
文件中更新DEEPSEEK_API_KEY
。
运行服务器
bash
python server.py
访问http://127.0.0.1:5000使用聊天界面。
调试方式
- 聊天端点:
- URL:
/chat
- Method:
POST
- Payload:
{ "message": "your message here" }
- MCP端点:
/mcp/list_tools
:列出可用工具。/mcp/call_tool
:直接调用工具命令。