MCP Stdio Bridge

MCP-STDIO桥接器

一个仅包含标准I/O（stdio）模型上下文协议（MCP）工具的微型运行时镜像 保持活跃并通过HTTP/SSE暴露它们。它的设计是为了能够轻松集成到一个 Kubernetes Pod（例如通过 servers[].stdioBridge （在……中的）街区 mcp-server Helm chart），但它也可以作为一个独立的容器来使用 本地测试。

里面是什么

uv tool run "$@"，所以像这样的命令 uvx mcp-server-reddit 只需工作 | tsx 适用于以TypeScript为主的MCP服务器。 | | mcp-proxy 0.9.x 保持stdio工具运行并提供SSE的桥接进程。 | | BusyBox 工具 | 由初始化脚本使用；无特殊之处。 |

两者都 amd64 和 arm64 每次发布时都会构建镜像。

快速入门（本地）

# Run a stdio-only MCP server with an SSE endpoint exposed at port 3000
docker run --rm -p 3000:3000 \
  ghcr.io/icoretech/mcp-stdio-bridge:0.3.1 \
  mcp-proxy --port 3000 -- npx chrome-devtools-mcp

容器在首次启动时会下载该工具（使用 npx， uvx等）和 使其保持活力。接下来的任何论点 -- 被传递给stdio服务器。

使用 uvx

因为该镜像附带了 uvx 预配置好的，您可以启动基于Python的（程序/应用） 服务器排成一列：

# Start the Reddit MCP server and bridge it to SSE
docker run --rm ghcr.io/icoretech/mcp-stdio-bridge:0.3.1 \
  uvx mcp-server-reddit

这会下载该软件包（缓存到容器内部）并运行它 mcp-proxy 自动地。替换 mcp-server-reddit 与任何紫外线兼容的（产品/材料） 标准输入输出工具。

Kubernetes / Helm（标准输入输出桥接）

当使用时 mcp-server Helm Chart，为每台服务器启用桥接：

servers:
  - name: reddit
    port: 3000
    stdioBridge:
      enabled: true
      image: ghcr.io/icoretech/mcp-stdio-bridge
      tag: 0.3.1
      passEnvironment: true
      serverCommand: ["uvx", "mcp-server-reddit"]
      serverArgs: []
    register:
      enabled: false

该图表已嵌入 mcp-proxy. 设置 passEnvironment: true 转发 将子进程的Pod环境设置为有用，这适用于API密钥或其他（内容） 配置。

有用的标志/选项

你可以通过任何（测试/考试等，具体根据上下文确定） mcp-proxy 在……之前的旗帜 -- 分隔符：

# Enforce a specific transport and allow all origins
docker run --rm ghcr.io/icoretech/mcp-stdio-bridge:0.3.1 \
  mcp-proxy --transport sse --allow-origin='*' --port 3000 -- \
  npx chrome-devtools-mcp

常见选项：

• --pass-environment / --no-pass-environment
• `--cwd

` 更改子进程的工作目录

• --named-server 从一个容器中暴露多个桥接目标

跑 docker run --rm ghcr.io/icoretech/mcp-stdio-bridge:0.3.1 mcp-proxy --help 以获取完整列表。

发布工作流程

这个仓库使用了Release Please：

1. 每次提交和拉取请求都会触发 *CI构建（持续集成构建）* 构建工作流

（不强制进行）并对运行时进行冒烟测试uv， uvx， node， python3， mcp-proxy）。

1. 合并发布请求（Release Please PR）会创建标签 vX.Y.Z。
2. 该标签触发发布工作流，将多架构镜像推送到

ghcr.io/icoretech/mcp-stdio-bridge 带有标签 vX.Y.Z， vX.Y，和 latest。

许可证

麻省理工学院（详见仓库中的LICENSE文件）。