tunnel-client

tunnel-client 概覽

這是什麼

tunnel-client 是 Secure MCP Tunnel 的客戶端 CLI 與 Go SDK。它透過 OpenAI 託管的 MCP 隧道端點，將私有或 localhost 的 MCP（Model Context Protocol）伺服器連接到 ChatGPT、Codex、Responses API 與 AgentKit，同時讓 MCP 伺服器不暴露於公開網際網路。

主要功能

• 將私有或 localhost 的 MCP 伺服器連接到 OpenAI 託管的產品，無需暴露於公開網際網路。
• 提供 CLI 與 Go SDK，可與 MCP 伺服器並行執行。
• 內建示範工具（server_info、echo、uppercase），使用 --embedded-stateless-mcp-stub 或 --embedded-mcp-stub 啟用。
• 提供運維可見的端點：/healthz、/readyz、/metrics 與 /ui。
• 支援 Docker、Kubernetes 與 VM 部署（詳見 docs/deployment/overview.md）。
• 支援 MCP 計時與分散式追蹤（選擇性啟用，使用 --mcp.forward-trace-context 與 --tracing.enabled）。
• 支援請求 ID 轉發（--forward-request-id）。
• 支援具命名空間的隧道 ID。
• 可透過記憶體傳輸將 MCP 伺服器直接嵌入 Go 程序（參見 examples/go-sdk-inmemory）。

使用情境

• 您的 MCP 伺服器位於筆電、VM、Kubernetes 叢集或私有網路，且需要 OpenAI 託管的產品存取它。
• 安全團隊不允許為 MCP 伺服器新增入站防火牆規則或公開端點。
• 您希望在連接器或 API 呼叫依賴之前，先有一個提供健康檢查與指標的運維可見守護程序。

快速開始

macOS 上透過 Homebrew 安裝： bash brew install openai/tools/tunnel-client 驗證版本並啟動引導設定： bash tunnel-client --version tunnel-client help quickstart 若使用 Go SDK，加入模組： bash go get github.com/openai/tunnel-client 使用執行階段 API 金鑰與隧道 ID 嘗試內建示範： bash export CONTROL_PLANE_API_KEY='sk-...' export CONTROL_PLANE_TUNNEL_ID='tunnel_0123456789abcdef0123456789abcdef' tunnel-client run --embedded-stateless-mcp-stub --health.listen-addr 127.0.0.1:0 如需 Docker、Kubernetes 或 VM 部署，請參閱儲存庫的 README。

授權與價格

採用 Apache-2.0 授權。此專案為開放原始碼且免費使用。

內容整理自該專案公開的 README 與儲存庫資訊。