DeepSeek MCP-like Server for Terminal

DeepSeek MCP-like Server for Terminal

site icon
2025.03.29 5
Python终端操作AI集成开发效率
DeepSeek MCP-like Server for Terminal 是一个基于DeepSeek API的原型实现,旨在展示模型上下文协议(MCP)的核心概念。它允许AI助手通过暴露的端点列出可用工具、在活动shell会话中调用命令,并与AI聊天(DeepSeek)集成,以触发命令执行。该项目目前是一个概念验证,尚未完全符合Anthropic定义的MCP服务器标准。
View on GitHub

Overview

基本能力

产品定位

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密钥

安装教程

  1. 克隆仓库bash git clone https://github.com/OthmaneBlial/term_mcp_deepseek.git cd term_mcp_deepseek
  2. 创建并激活虚拟环境bash python3 -m venv venv source venv/bin/activate # Windows用户使用`venv\Scripts\activate`
  3. 安装依赖bash pip install -r requirements.txt
  4. 配置API密钥: 在.env文件中更新DEEPSEEK_API_KEY

运行服务器

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:直接调用工具命令。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。