初始化请求

初始化请求

所有 MCP 会话必须以 initialize 请求开始，用于协商协议版本、声明客户端能力。服务端返回服务端能力后，客户端需发送 notifications/initialized 通知确认会话建立完成。

请求示例

POST /mcp HTTP/1.1
Host: mcp.intl.unveilchem.com
Content-Type: application/json
X-API-Key: your-api-key

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {},
    "clientInfo": {
      "name": "test-client",
      "version": "1.0.0"
    }
  }
}

参数说明

字段	类型	必填	说明
jsonrpc	string	是	固定为 "2.0"
id	number | string	是	请求 ID，用于匹配响应
method	string	是	固定为 "initialize"
params.protocolVersion	string	是	协议版本，当前为 "2024-11-05"
params.capabilities	object	是	客户端能力声明，可为空对象
params.clientInfo.name	string	是	客户端名称（用于日志追踪）
params.clientInfo.version	string	是	客户端版本

响应示例

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": {
      "tools": {
        "listChanged": true
      }
    },
    "serverInfo": {
      "name": "chemflow-mcp",
      "version": "2.0.0"
    }
  }
}

完成握手

收到 initialize 响应后，客户端需发送 notifications/initialized 通知，正式完成会话建立：

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

注意：notifications/initialized 是通知，无 id 字段，服务端不会返回响应。

下一步

会话建立完成后，可调用 tools/list 获取可用工具清单。