McpConnection

MCP 连接(transport 层对上唯一面孔)。 握手(initialize/initialized)、版本协商、session 头都发生在 connect 工厂 内部;返回的连接恒处 ready 态,closed 后一切请求以结构化 McpError 拒绝。

属性

instructions?

readonly optional instructions?: string;

CW17-M2A(doc/60 §3.4)— initialize 返回的 server instructions,拾取时 已过 2K 帽+消毒(stream-connection validateInitializeResult)。恒不进 系统提示;注入时机 = 该 server 首次被 McpDiscover 展开(走消息流增量, 可压缩可淘汰)。服务端未提供时为 undefined。

---

protocolVersion

readonly protocolVersion: string;

协商定格的协议版本

---

serverCapabilities

readonly serverCapabilities: Record<string, unknown>;

---

serverInfo

readonly serverInfo: McpPeerInfo | undefined;

---

serverName

readonly serverName: string;

---

state

readonly state: McpConnectionState;

---

transport

readonly transport: McpTransportKind;

方法

close()

close(): Promise<void>;

幂等关闭:失败所有 in-flight、释放底层资源(stdio 杀进程 / http 发 DELETE)

返回

Promise<void>

---

notify()

notify(method, params?): Promise<void>;

JSON-RPC 通知(单向)

参数

method

string

params?

Record<string, unknown>

返回

Promise<void>

---

request()

request(
   method,
   params?,
   opts?
): Promise<unknown>;

JSON-RPC 请求;取消经 opts.signal → cancel 通知 + 本地拒绝

参数

method

string

params?

Record<string, unknown>

opts?

McpRequestOptions

返回

Promise<unknown>

---

settleClose()?

optional settleClose(): Promise<void>;

加法完成层;只等待本地传输资源,不承诺远端服务终止。

返回

Promise<void>

本文是否有帮助?

有帮助没帮助