DeepSeek MCP-like Server for Terminal

Term MCP DeepSeek

在运行任何内容之前，先查看命令、风险、工作区和限制。然后，保留一份经过签名的实际执行记录。

Term MCP DeepSeek 是一个面向 MCP 客户端和用户、以审批为先的本地终端控制平面。它为 DeepSeek 提供隔离的建议角色，同时由确定性策略负责命令规划、审批、受限执行、实时事件和签名证据。

探索交互式项目网站 →

为什么要做这个项目

大多数终端 Agent 会把建议和执行合并成一个不透明的环节。Term MCP DeepSeek 让两者之间的界限清晰可见：

intent → versioned plan → policy decision → human approval → bounded process → signed receipt

• 模型文本绝不会直接执行。
• 检查模式默认只读。
• 每条命令都会在不使用 shell 的情况下解析，并限定在一个工作区内。
• 暂停、恢复、取消、超时、输出限制和进程隔离都是一等状态。
• 即使 DeepSeek 不可用或处于离线状态，本地 MCP 工具仍可正常使用。
• 回执会分别记录命令、stdout、stderr、退出代码、信号、权限和签名。
• 可分享的导出内容会移除命令文本、工作区路径、参数和输出，然后重新签名，生成有效签名。

60 秒内获得第一个结果

要求：macOS 或 Linux、Python 3.10–3.13，以及 pipx。

pipx install "git+https://github.com/OthmaneBlial/[email protected]"
cd /path/to/the/repository/you/want/to/inspect
term-mcp serve

服务会输出一个一次性承载令牌。打开 http://127.0.0.1:8000，粘贴该令牌，选择 检查工作区，然后依次选择 构建计划和执行。

预期结果：UI 会在执行前显示一个低风险的 pwd 计划，随后生成一份状态为 succeeded 的回执，其中包含退出代码 0、分别记录的 stdout/stderr，以及经过验证的 HMAC 签名。无需 DeepSeek 密钥。

按 Ctrl+C 停止服务。生成的令牌和内存中的会话会随进程一同消失。

从克隆仓库安装

参与贡献或测试尚未发布的更改时，请使用此方式：

git clone https://github.com/OthmaneBlial/term_mcp_deepseek.git
cd term_mcp_deepseek
./startup.sh token
./startup.sh

startup.sh 会创建 .venv、安装软件包，并转交给打包安装所用的同一个 term-mcp CLI。

安全边界

默认设置为 APPROVAL_MODE=inspect，并禁用网络。

模式	适用场景	写入操作	项目代码	审批
inspect	探查代码仓库	禁止	禁止	仅限长时间运行的进程
confirm	审慎的本地工作	按策略限定	策略允许时可执行	高风险操作需要审批
trusted	预先批准的自动化	按策略限定	策略允许时可执行	预先批准，始终记录回执

confirm 和 trusted 模式并非操作系统沙箱。请在一次性容器或虚拟机中测试不可信的代码仓库。将 WORKSPACE_ROOT 限定在较小范围内，设置 ALLOW_NETWORK=false，切勿将 HTTP 服务直接暴露给不可信网络。

启用更广泛的命令范围之前，请阅读 SECURITY.md 和威胁模型。

CLI

term-mcp serve                       production HTTP server (Waitress)
term-mcp serve --debug               Flask development server
term-mcp stdio                       JSON-RPC over STDIO
term-mcp doctor --json               config, permissions, shell, and transport checks
term-mcp doctor --connectivity        optional DeepSeek endpoint check
term-mcp demo                        no-key guided scenarios
term-mcp receipt validate FILE       schema and HMAC validation
term-mcp receipt show FILE           privacy-aware summary
term-mcp recipe validate FILE...     schema and policy validation
term-mcp recipe run FILE             inspect-only recipe execution
term-mcp token                       strong bearer token generator
term-mcp version                     installed version

运行完整的本地质量检查：

./local_ci.sh

安全配方目录

代码仓库包含 6 个简短工作流，涵盖代码仓库检查、Python 和 JavaScript 测试发现、日志清单、端口配置，以及只读边界证明。每个配方都带有架构版本，仅用于检查、无需网络、不写入数据、范围受限，并且运行前会经过生产策略检查。

term-mcp recipe validate examples/recipes/*.json --workspace .
term-mcp recipe run examples/recipes/inspect-repository.json --workspace .

浏览配方目录和贡献模板。CI 会执行完整目录，并运行无模型基准测试。

请参阅证明示例集，了解经签名且已去除共享敏感信息的成功、取消和超时回执。三个简短演示展示了如何将这些配方用于陌生代码仓库、测试范围和本地事件证据。

MCP 客户端

服务器面向现代 MCP 2026-07-28，并支持旧版 2025-11-25 初始化生命周期。HTTP 和 STDIO 共用一个分发器和工具目录。

推荐的本地 STDIO 配置：

{
  "mcpServers": {
    "term-mcp-deepseek": {
      "command": "/absolute/path/to/term-mcp",
      "args": ["stdio"],
      "env": {
        "WORKSPACE_ROOT": "/absolute/path/to/your/project",
        "APPROVAL_MODE": "inspect"
      }
    }
  }
}

STDOUT 仅包含 JSON-RPC 消息；诊断信息会输出到 STDERR。协议详情和带日期的客户端证据，请参阅 MCP 兼容性矩阵。

HTTP 和 Web API

受保护的路由需要 Authorization: Bearer $AUTH_TOKEN。公共路由仅限 UI 外壳、健康检查、演示、静态资源和回执架构。

方法	路径	身份验证	用途
GET	/health	公共	就绪状态和软件包版本
GET	/	公共	审批优先的任务控制台
GET	/demo/scenarios	公共	无需密钥的本地演示目录
GET	/schemas/receipt-1.0.json	公共	回执 JSON 架构
POST	/mcp	Bearer	现代或旧版 MCP 调用
DELETE	/mcp	Bearer	关闭旧版 MCP 传输会话
GET	/mcp/info	Bearer	运行时、限制、模型和协议信息
POST	/sessions	Bearer	创建隔离的 Web 执行会话
DELETE	/sessions/{id}	Bearer	关闭 Web 会话并停止其进程
GET	/stream?session_id=...	Bearer	会话范围内的执行事件
POST	/chat	Bearer	DeepSeek 提供建议的文本；绝不执行操作
POST	/receipts/validate	Bearer	验证架构和本地签名
POST	/receipts/redact	Bearer	移除私密内容，并重新签名以供分享

/sessions、/stream 和 /chat 路由是 Web 兼容 API，并非独立的 MCP 传输方式。

Docker

此镜像使用固定版本的 Python 基础镜像，在独立阶段构建 wheel，在运行时阶段离线安装，并以 UID/GID 10001 运行。

export AUTH_TOKEN="$(python3 -c 'import secrets; print(secrets.token_urlsafe(32))')"
docker compose up --build

打开 http://127.0.0.1:8000。由于默认模式为 inspect，compose 工作区挂载为只读。使用 docker compose down 停止。

配置

无需密钥的默认配置足以用于本地检查。仅在需要持久化配置时复制 .env.example：

cp .env.example .env
term-mcp token
term-mcp doctor

不要提交 .env。仅在使用可选顾问面板时添加 DEEPSEEK_API_KEY。完整的变量参考以及部署和回滚指南，请参阅运维文档。

项目导航

区域	信息来源
交互式概览和网页文档	项目网站
产品和信任边界	架构
支持与不支持的行为	功能矩阵
MCP 版本和客户端	兼容性
部署和回滚	运维
安全假设	安全策略和威胁模型
安全示例	配方目录
回执和具体演示	证明集和演示脚本
本地性能证据	基准测试规范
无遥测的采用情况	采用证据
方向和验收标准	路线图
发布历史	变更日志

贡献

欢迎提交小型测试、协议测试样例、安全配方、无障碍改进和客户端兼容性报告。请从 CONTRIBUTING.md 开始，运行 ./local_ci.sh；如果终端执行错误生成了回执，请附上脱敏后的回执。

安全漏洞应通过 GitHub 私密漏洞报告渠道提交，切勿在公开议题中报告。

许可证

MIT — 请参阅 LICENSE。