1. 初始化是什么？ #

• 什么是 MCP 规范？
• 什么是 MCP 架构？
• 什么是基础协议？
• 什么是传输？
• 什么是生命周期？
• python-sdk

客户端和 MCP 服务器建立连接后，第一件事必须是初始化（握手），然后才能调工具、读资源。

可以把它想成打电话：

没有完成初始化就发业务请求，属于协议错误。

2. 初始化在交换什么？ #

握手时双方交换三类信息，你只需知道含义，不必手写 JSON：

2.1 服务器常见能力 #

2.2 用 FastMCP 时你需要做什么？ #

服务器端：几乎不用管。 注册 `@mcp.tool()后，FastMCP 会在初始化响应里自动声明tools` 能力。

客户端：调用一行 await session.initialize()，SDK 自动完成三步握手。

3. 三步握手流程 #

规则：服务器在收到 initialized 之前，不应向客户端发业务请求（ping、日志除外）。

4. 消息长什么样？ #

实际开发中由 SDK 自动生成。下面帮助你看懂 Inspector 里的原始 JSON。

4.1 客户端发的 initialize 请求 #

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": {
      "name": "example-client",
      "version": "1.0.0"
    }
  }
}

4.2 服务器回的响应 #

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2025-11-25",
    "capabilities": {
      "tools": { "listChanged": true }
    },
    "serverInfo": {
      "name": "hello-server",
      "version": "1.0.0"
    }
  }
}

4.3 客户端发的就绪通知 #

{
  "jsonrpc": "2.0",
  "method": "notifications/initialized"
}

注意：通知没有 id 字段，也不会收到回复。

5. 服务器端用法 #

服务器不需要自己写 initialize 处理逻辑。写好工具、启动服务即可。

5.1 服务器 #

initialize_server.py

# 导入 FastMCP 模块，用于自动处理 initialize 握手
from mcp.server.fastmcp import FastMCP

# 创建 FastMCP 服务器实例，name 参数会显示在 serverInfo 里
mcp = FastMCP(name="hello-server")

# 使用装饰器注册 greet 工具，初始化时会自动声明 tools 能力
@mcp.tool()
def greet(name: str = "World") -> str:
    # 返回问候语字符串
    return f"Hello, {name}!"

# 判断是否作为主程序运行
if __name__ == "__main__":
    # 以 stdio 模式启动服务器，等待客户端连接
    mcp.run(transport="stdio")

6. 客户端用法 #

客户端的核心就两步：连上服务器 → 调用 initialize()。

6.1 完整示例 #

# 官方客户端 API 是异步的
import asyncio
# 导入操作系统相关的模块，用于处理文件路径等
import os
# 导入系统相关的模块，用于获取解释器路径等
import sys

# 导入会话类和子进程启动参数，用于与服务器通信
from mcp import ClientSession, StdioServerParameters
# 导入 stdio 传输模块，用于通过标准输入输出连接服务器
from mcp.client.stdio import stdio_client


# 定义主异步函数
async def main() -> None:
    # 获取当前文件所在目录的绝对路径
    base_dir = os.path.dirname(os.path.abspath(__file__))
    # 拼接服务器脚本的完整路径
    server_path = os.path.join(base_dir, "initialize_server.py")

    # 配置服务器子进程启动参数
    server_params = StdioServerParameters(
        # 指定 Python 解释器的路径
        command=sys.executable,
        # 指定启动的服务器脚本
        args=[server_path],
    )

    # 建立 stdio 连接并自动启动子进程
    async with stdio_client(server_params) as (read, write):
        # 创建会话对象，与服务器进行通信
        async with ClientSession(read, write) as session:
            # ★ 进行初始化握手，必须最先调用
            result = await session.initialize()

            # 初始化成功后，输出协商得到的信息
            print("协议版本:", result.protocolVersion)
            # 判断服务器信息是否存在，存在就输出名称，否则输出“未知”
            print("服务器名称:", result.serverInfo.name if result.serverInfo else "未知")

            # 初始化完成后，可以调用业务接口
            tools = await session.list_tools()
            # 输出获取到的工具列表名称
            print("工具列表:", [t.name for t in tools.tools])


# 如果当前模块为主程序则执行 main
if __name__ == "__main__":
    asyncio.run(main())

6.2 运行 #

uv run initialize_client.py

期望输出：

协议版本: 2025-11-25
服务器名称: hello-server
工具列表: ['greet']

6.3 initialize() 返回什么？ #

await session.initialize() 返回 InitializeResult 对象，常用字段：

6.4 常见写法注意点 #

7. 用 Inspector 验证初始化 #

• MCP Inspector

7.1 启动 Inspector #

npx @modelcontextprotocol/inspector uv run initialize_server.py

7.2 如何判断成功 #

浏览器打开后，看以下信号：

7.3 在 Inspector 里观察消息顺序 #

展开通知/日志面板，正常顺序应为：

1. initialize 请求 → 响应
2. notifications/initialized
3. 之后才有 tools/list 等

8. 初始化之后做什么？ #

初始化只是「接通电话」，之后才能干正事：