DeepSeek-TUI

Why this agent

DeepSeek-TUI 是开源的终端 AI 编程助手,用 Rust 写成,采用 Codex 风格的 13-crate 工作区结构。它 直接对接 api.deepseek.com,在 macOS / Linux / Windows 上提供沙箱化 工具执行,同时既是 MCP 客户端也是 MCP 服务端 (deepseek mcp serve)。

Prerequisites

• 已安装 DeepSeek-TUI(npm install -g deepseek-tui、 cargo install deepseek-tui-cli,或 release 二进制)。deepseek --version 能跑。
• 已配置 DeepSeek API key(通过 deepseek auth 或 DEEPSEEK_API_KEY 环境变量)。
• espctl 已安装在磁盘上某个稳定位置(下文需要完整路径)。
• (可选,用于远程构建)Aegis 构建服务器地址 + MCP_AUTH_SECRET。

Install snippet (or alternative)

DeepSeek-TUI 从 ~/.deepseek/mcp.json 读取 MCP 服务列表。粘贴下面 这段(或者用 deepseek mcp add espctl /path/to/espctl mcp serve CLI):

{
  "mcpServers": {
    "espctl": {
      "command": "/path/to/espctl",
      "args": ["mcp", "serve"],
      "env": {
        "CONTROL_BASE_URL": "https://esphome.cloud",
        "MCP_AUTH_SECRET": "your-access-key"
      }
    }
  }
}

替换:

• /path/to/espctl —— 你电脑上 espctl 程序的完整路径。
• CONTROL_BASE_URL —— 你的 Aegis 构建服务器地址。把它(和 MCP_AUTH_SECRET)留空就是仅计划模式。
• MCP_AUTH_SECRET —— 构建服务器给你的访问密钥。

和 Claude Code 不同,DeepSeek-TUI 是从项目目录里启动的 (cd /path/to/project && deepseek),所以片段里不需要 cwd 字段。

或者 —— 拿到预填好的代码片段:

读取 install://deepseek-tui 资源。

First-run verification

在项目目录下跑 deepseek mcp list 确认 espctl 出现在已注册的服务里, 然后启动 DeepSeek-TUI 问:

deepseek
> 你有哪些 espctl 工具?

预期:列出约 40 个 espctl 工具。

Troubleshooting

• 启动时报 mcp.json 解析错 → 单独跑 deepseek mcp list,解 析错信息会指向出错的行。
• 列出了工具但每次调用都返回 “auth required” → 你的 MCP_AUTH_SECRET 缺失或已失效。回到控制面重新签发一份访问密钥再填进配置。
• DeepSeek-TUI 启动了但没注册任何 MCP 服务 → 检查 ~/.deepseek/mcp.json 是否存在且是合法 JSON。deepseek doctor 会报告常见配置问题。

Tested as-of 2026-05-19

DeepSeek-TUI 作为 MCP 服务端

deepseek serve --http 暴露一个 /v1/* 运行时 API。如果你想让 DeepSeek-TUI 自己也能被当作 MCP 服务端访问(同时还在客户端侧挂载 espctl),见 DeepSeek-TUI 的 RUNTIME_API.md。