moltline-mcp 是 Moltline Studio 托管 MCP 服务器集群的 stdio 桥接工具，采用零依赖设计，仅依赖 Python 3.9+ 标准库。它面向只支持 stdio 传输的 MCP 客户端，将客户端与托管服务器之间的换行分隔 JSON-RPC 消息原样代理转发，不收集遥测数据。
用途：为仅支持 stdio 传输的 MCP 客户端提供连接 Moltline Studio 托管 MCP 服务器集群的桥梁。大多数现代 MCP 客户端可直接通过 Streamable HTTP 连接集群，无需安装；该桥接专为只支持 stdio 的客户端而设。
主要能力：集群包含 22 个托管 MCP 服务器、160 个工具，其中 110 个免费。免费层无需注册、账户或凭据，连接后即可调用工具。高级工具需通过 Moltline 许可证解锁。桥接支持通过环境变量 MOLTLINE_LICENSE 传递许可证，作为 X-Moltline-License 请求头发送，且不会写入命令行参数、URL 或日志。支持 --timeout 设置每请求超时（默认 300 秒，或环境变量 MOLTLINE_TIMEOUT）、--list 打印服务器 slug 并退出、MOLTLINE_BASE_URL 覆盖集群基础 URL、MOLTLINE_DEBUG=1 在 stderr 输出诊断日志（stdout 保持协议干净）。
使用方式：推荐直接连接，若客户端支持 Streamable HTTP（如 Claude Desktop、Claude Code、Cursor 及多数当前客户端），直接指向托管端点即可，无需安装。对于仅支持 stdio 的客户端，可运行桥接脚本（单文件，仅标准库，克隆即可用），或通过 Docker 容器运行（需先 docker build -t moltline-mcp .）。客户端配置需指向脚本的绝对路径，或通过 Docker 运行。桥接每个服务器连接一个进程，从 stdin 读取的每条 JSON-RPC 消息 POST 到 https://mcp.moltlinestudio.com/<server>，JSON 和 SSE 帧响应以换行分隔 JSON 中继回 stdout。桥接跟踪服务器分配的 Mcp-Session-Id，并回显协商的 MCP-Protocol-Version，符合 Streamable HTTP 传输规范。
适用场景：需要连接 Moltline Studio 托管 MCP 服务器集群但客户端仅支持 stdio 传输的场景。集群工具涵盖代码审查、代理治理、商业数学、监管截止日期、加密税批、路由和优化等。
限制：桥接本身不检查、存储或报告用户流量。高级工具需要 Moltline 许可证，需在 moltlinestudio.com 购买（人工介入）。许可证故意不作为命令行标志，因为 argv 可通过 ps 被全局读取；也从不放入 URL 或日志。PyPI 包计划中，目前需使用上述方法。桥接附带离线测试套件，无需网络和依赖，包含 22 个测试，覆盖换行分隔帧、SSE 事件拆分（多事件、多行 data: 负载、无空行的尾随事件、注释和命名事件）、会话 ID 捕获复用、仅在 initialize 时协商协议版本、错误转发（JSON-RPC 错误文档原样传递，其他变为格式良好的 -32603）。CI 在 Python 3.9、3.12 和 3.13 上运行，外加 Docker 构建和容器冒烟测试。
