背景
这次迁移的目标很直接:给国内链路提供更稳的 MCP 服务源。服务端分发包已经切到新地址,但旧客户端仍可能持有旧 endpoint,所以必须按 breaking change 处理。
工程侧跟踪在 ml8s/liki-mingli issue #2。
现在的 endpoint 口径
新配置分两类。free 配置保留 engine 和 counsel 两个 server:
json
{
"mcpServers": {
"engine": {
"type": "streamableHttp",
"url": "https://mcp.tokflux.com/engine/mcp"
},
"counsel": {
"type": "streamableHttp",
"url": "https://mcp.tokflux.com/counsel/mcp"
}
}
}
pro 聚合入口使用单 server:
json
{
"mcpServers": {
"liki": {
"type": "streamableHttp",
"url": "https://mcp.tokflux.com/mcp"
}
}
}
旧路径 /engine/mcp、/counsel/mcp 如果没有兼容代理,客户端会拿到 404。
更新方式
大多数用户不需要手改 JSON,重新执行官方更新命令即可:
bash
npx skills add ml8s/liki -y
更新后重点检查两件事:
- 宿主是否重新加载了 MCP server 配置。
tools/list是否能返回工具集合;engine 应有排盘工具,counsel 应有断语工具。
建议加三个迁移护栏
1. 健康检查不要只测 TCP
只检查域名解析或 TCP 连通不够。至少发一次 MCP initialize,再发 tools/list,确认协议层可用:
json
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-03-26",
"capabilities": {},
"clientInfo": {
"name": "migration-smoke",
"version": "0"
}
}
}
2. 版本信息要稳定暴露
如果客户端靠 VERSION.txt 或 serverInfo.version 做门禁,endpoint 迁移时它们也要可达。版本口径最好同时支持:
- 人类可读的 release tag;
- 机器可比较的 semver 或 CalVer;
- 必要时的构建 SHA。
3. 旧 endpoint 要有兼容策略
按代价从低到高:
- 返回结构化
endpoint_migrated错误; - 旧路径短暂代理到新服务;
- 在 endpoint 响应头或 body 中提示新地址;
- 所有分发渠道同步公告。
只返回 HTML 404 对自动化客户端最不友好。
发布面清单
这次不只改仓库配置,还要检查:
- README 更新命令;
- GitHub release note;
- SkillHub listing;
- WorkBuddy 渠道包;
- Smithery 配置;
- 站内文档;
- 支持群排障模板。
本文只记录服务迁移经验,不涉及命理结论。传统文化视角,仅供参考,不构成专业建议。