跳转至

WebSocket 连接规范 (WebSocket Connection)

websocket 连接类型允许 Griptape Nodes 利用底层 WebSocket 协议与远程 MCP 服务器建立低延迟、长连接的原生全双工通信通道。

技术规范备忘：虽然目前在官方最新 MCP 传输规范核心层中，WebSocket 尚未被列为首选基础协议（官方核心推荐为 stdio 与 Streamable HTTP），但依照 MCP 架构规范 的开放设计，任何客户端或服务端均可将其作为自定义传输层 (Custom Transport) 灵活扩充实现。

什么是 WebSocket？

WebSocket 是一种在单个持久化 TCP 连接上提供全双工（Full-Duplex）双向通信的高性能网络协议。与传统的短连接轮询或标准 HTTP 相比，WebSocket 握手成功后协议头部开销极低，客户端与服务端双方均可在任意时刻主动向对方发送帧数据。

生态演进现状 (Coming Soon)

基于 WebSocket 的 MCP 生态目前仍处于各家开源社区的持续演进探索阶段。虽然协议通道已在底层技术架构中预留，但目前社区中绝大多数主流 MCP 服务依然主要基于标准 stdio 或 Streamable HTTP 构建。

现阶段的推荐工程实践：

预期配置规范范本 (Configuration)

当对接自定义 WebSocket MCP 服务器时，其配置语法遵循如下结构：

{
  "transport": "websocket",
  "url": "ws://your-websocket-server.com/mcp",
  "headers": {
    "Authorization": "Bearer your-api-key"
  }
}
  • transport：显式声明为 "websocket"；
  • url：以 ws:// 或带 TLS 加密的 wss:// 开头的 WebSocket 服务端点；
  • headers：用于连接建立阶段（Handshake 握手阶段）透传的身份验证报头。

推荐延伸阅读