MCP服务器自动发现新标准详解：/.well-known/mcp.json文件配置指南

MCP Server 自动发现机制详解：/.well-known/mcp.json 新标准正式落地

MCP 生态系统近日迎来一项重要进展：/.well-known/mcp.json 自动发现机制已开始实际部署。这意味着客户端不再需要手动告知“这里存在 MCP 服务”，而是能够自主完成服务发现。该机制基于一套标准化的路径约定，与互联网上早已通用的 robots.txt 类似，为开发者提供了更简洁的服务接入方式。

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

简而言之，它是一个固定且约定俗成的网络路径。任何 MCP 客户端只需访问服务端域名下的 /.well-known/mcp.json，即可获取一份 JSON 配置文件，其中清晰地列出了该服务端提供了哪些 MCP 工具以及连接方式。

举例来说，访问 aiphotoshop.mynatapp.cc/.well-known/mcp.json，您可能会看到类似这样的配置：

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

这份 JSON 文件告知客户端：这里存在一个名为 shotapi 的 MCP 服务，类型为 streamable-http，访问地址为 https://aiphotoshop.mynatapp.cc/mcp，主要提供截图与 HTML 渲染功能。

streamable-http 与 stdio 的区别

这里需要区分两个概念：streamable-http 和 stdio。

传统的 stdio 模式要求用户在本地安装各类依赖库，配置过程相对复杂。而 streamable-http 的核心优势在于“一行配置即可完成集成”。以上述示例为例，您只需在客户端执行一条命令：

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

客户端即可通过 HTTP 协议与服务端通信，完全摆脱本地环境依赖。

技术实现原理

streamable-http 的传输流程并不复杂，核心步骤仅有三步：

1. 客户端向 MCP 的 endpoint 发送一个 POST 请求。
2. 服务端以 JSON-RPC 格式返回响应数据。
3. 整个过程支持长连接与流式传输，非常适合对实时性要求较高的应用场景。

这套机制确保客户端与服务端之间能够实现结构化、双向的通信，而不仅仅是简单的“请求-响应”模式。

实际应用案例

以 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。