MCP Server 自动发现：/.well-known/mcp.json 新标准详解

用户788157868332026-06-09 10:40

MCP Server 自动发现机制详解

MCP最新发展：/.well-known/mcp.json 自动发现机制------客户端可以自动发现可用的 MCP 服务。

/.well-known/mcp.json 是什么？

这是一个类似 /.well-known/ 的标准路径（类比 robots.txt），MCP 客户端访问这个路径就能知道服务端提供了哪些 MCP 工具。

实际例子：aiphotoshop.mynatapp.cc/.well-known...

json 复制代码

{
  "mcpServers": {
    "shotapi": {
      "type": "streamable-http",
      "url": "https://aiphotoshop.mynatapp.cc/mcp",
      "description": "Screenshot & HTML render MCP server"
    }
  }
}

streamable-http vs stdio

stdio 需本地安装依赖，streamable-http 一行配置即可：

bash 复制代码

claude mcp add --transport streamable-http shotapi https://aiphotoshop.mynatapp.cc/mcp

技术原理

streamable-http 传输流程：

POST 请求到 MCP endpoint
JSON-RPC 格式响应
支持长连接和流式传输

实际应用

以 ShotAPI 为例，三个 MCP 工具：

screenshot_one_liner：截图 URL
screenshot：CSS 选择器定位
render：HTML 渲染成图

配置：

json 复制代码

{
  "mcpServers": {
    "shotapi": {
      "type": "streamable-http",
      "url": "https://aiphotoshop.mynatapp.cc/mcp"
    }
  }
}

文档：aiphotoshop.mynatapp.cc/docs