管弦乐队插件:传输quic桥
一个传输插件 乐团MCP 将远程本地客户端(桌面/移动应用程序)连接到编排器的框架 QUIC+mTLS.
对于浏览器客户端,请使用 orchestra serve --web-gate :9201 相反,它直接从进程内路由器提供WebSocket JSON-RPC网关。
安装
go install github.com/orchestra-mcp/plugin-transport-quic-bridge/cmd@latest用法
transport-quic-bridge \
--orchestrator-addr localhost:9100 \
--listen-addr :9200 \
--certs-dir ~/.orchestra/certs \
--api-key my-secret-key环境变量
所有标志都可以通过环境变量进行配置:
| 标志 | 环境变量 | 默认值 | 描述 |
|---|---|---|---|
--orchestrator-addr | ORCHESTRA_ORCHESTRATOR_ADDR | localhost:9100 | 编排器QUIC地址 |
--listen-addr | ORCHESTRA_LISTEN_ADDR | :9200 | QUIC侦听器地址 |
--certs-dir | ORCHESTRA_CERTS_DIR | ~/.orchestra/certs | mTLS证书目录 |
--api-key | ORCHESTRA_API_KEY | *(无身份验证)* | 客户端身份验证的API密钥 |
运作原理
此传输插件通过mTLS QUIC连接到Orchestra编排器,并为本地桌面/移动应用程序公开QUIC端点。每个请求-响应对都使用一个专用的QUIC双向流,该流具有长度分隔的JSON-RPC 2.0帧。
协议
- 框架:
[4-byte big-endian uint32 length][JSON payload] - 最大邮件大小: 16 MB
- TLS: 1.3(仅适用于服务器,不适用于客户端的mTLS)
- ALPN:
orchestra-bridge
支持的方法
| 方法 | 说明 |
|---|---|
initialize | MCP协议握手 |
ping | 健康检查(退货 {}) |
tools/list | 列出所有可用的MCP工具 |
tools/call | 调用MCP工具 |
prompts/list | 列出可用提示 |
prompts/get | 按名称获取提示 |
authenticate | 使用API密钥进行身份验证 |
认证
第一个流必须发送 authenticate 具有匹配API密钥的方法。同一连接上的所有后续流都经过预身份验证。如果未配置API密钥,则允许所有连接。
