Day 0 适配:DSH 发布当日,Stata-MCP 即完成适配

Day 0 不是一句发布口号。它意味着一个新工具出现时,研究者当天就能把自己已经在使用的 Stata 工作流接进去。

为什么要在当天适配

DeepSeek Harness 为智能体提供了新的运行环境,但“支持 MCP”不等于已有工具可以直接使用。Stata-MCP 需要正确接入它内置的 MCP 客户端桥接层,还要处理工具命名、长时间运行和断线恢复。

对研究者来说,真正重要的不是配置文件长什么样,而是原有的 Stata 数据、do-file 和研究流程能否继续工作。因此我们的目标很明确:尽可能把适配复杂度留在安装器和文档里,让使用者只面对一条安装命令。

当天完成了什么

我们把 DeepSeek Harness 加入 Stata-MCP 的安装目标,并同时完成了四件互相依赖的工作:

  1. 通过 @deepseek-ai/dsh-mcp-client 接入它的 MCP 桥接层。
  2. 固定使用 serverName: stata-mcp,确保工具名称稳定为 mcp__stata-mcp__*。
  3. 把单次工具调用上限设置为 20 分钟,让较大的回归和数据导入不会被默认短超时中断。
  4. 为连接异常保留自动重连,并把一键安装、手动配置和验证步骤写进中英文文档。

一条命令完成安装

最短的使用路径是:

uvx stata-mcp install -c dsh

安装器负责把 Stata-MCP 注册进 DeepSeek Harness 的用户配置。完成后,常用能力会以 mcp__stata-mcp__stata_do、mcp__stata-mcp__get_data_info、mcp__stata-mcp__help 等工具出现。

我们验证了什么

检查项Day 0 结果
MCP 服务器标识固定为 stata-mcp
运行方式本地 stdio 进程
长任务上限20 分钟
断线恢复最多尝试 5 次
安装入口dsh 与 deepseek-harness 均可识别

这次适配随后进入 Stata-MCP v1.22.0。同一版本还改进了数据缓存格式、MCP 客户端兼容性和可用版本提示,但 Day 0 支持的核心标准始终是:安装路径明确、配置可以验证、工具能够实际出现。

这次工作留下的经验

新客户端的适配不能只检查“配置文件写进去了”。至少还要分别确认:客户端能读取配置、服务器能启动、工具命名正确、长任务不会提前中断,以及文档中的命令与安装器真正写入的内容一致。

这也是我们希望 Blog 保留下来的部分:不仅宣布做成了什么,还记录当时怎样判断、怎样验证,以及下一次遇到相似问题时可以复用什么。

资料与复现