MCP endpoint 迁移清单:旧域名 404、双服务源与客户端更新

背景

这次迁移的目标很直接:给国内链路提供更稳的 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

更新后重点检查两件事:

  1. 宿主是否重新加载了 MCP server 配置。
  2. 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 要有兼容策略

按代价从低到高:

  1. 返回结构化 endpoint_migrated 错误;
  2. 旧路径短暂代理到新服务;
  3. 在 endpoint 响应头或 body 中提示新地址;
  4. 所有分发渠道同步公告。

只返回 HTML 404 对自动化客户端最不友好。

发布面清单

这次不只改仓库配置,还要检查:

  • README 更新命令;
  • GitHub release note;
  • SkillHub listing;
  • WorkBuddy 渠道包;
  • Smithery 配置;
  • 站内文档;
  • 支持群排障模板。

本文只记录服务迁移经验,不涉及命理结论。传统文化视角,仅供参考,不构成专业建议。

相关推荐
字节跳动开源1 天前
小红书/抖音图文排版利器——一个杂志风skill
人工智能·开源·设计
wangruofeng3 天前
给前端开发者的 100 个设计参考网站
前端·设计
ZhengEnCi4 天前
登录页电脑端怎么设计才不空:5 种布局方案与可粘贴 AI 提示词
前端·css·设计
ZhengEnCi12 天前
为什么苹果的圆角更高级:连续曲率圆角 Squircle 从超椭圆到 CSS 实现的完全讲解
css·设计
用户69190268133915 天前
Redis 1:简述Redis概念与Agent的联系
redis·后端·设计
桑榆肖物16 天前
CoverFlow:一个会自己动手改画布的封面设计器
设计
l1m0_18 天前
AI设计工具有哪些?Paico、Pixso AI、墨刀AI、Lovable、Codex怎么选
前端·人工智能·ai·设计·墨刀·codex·pixso
梦想很大很大19 天前
让 Codex 自由发挥,给 nvm-desktop 换个 UI
前端·人工智能·设计
广州智造21 天前
Radioss混凝土材料仿真案例
设计·cad·建模·cae·仿真软件·radioss