基本能力
产品定位
Minibridge作为后端与前端之间的桥梁，优化和保障了代理与MCP服务器之间的通信安全，同时支持SBOM生成和验证，确保服务器完整性。
核心功能
- 通信桥梁：安全地暴露MCP服务器到互联网，支持HTTP/SSE和WebSocket通信。
- 策略服务集成：支持通过HTTP或OPA Rego策略进行代理认证、内容分析和转换。
- SBOM支持：生成和验证MCP服务器的SBOM，确保服务器未被篡改。
- 多种前端模式：支持Stdio、HTTP+SSE等多种前端通信模式。
适用场景
- 安全通信：需要在代理与MCP服务器之间建立安全通信的场景。
- 策略控制：需要对代理请求进行认证、授权或内容分析的场景。
- 服务器完整性验证：需要确保MCP服务器未被篡改的场景。
工具列表
- minibridge aio：作为单一网关启动，支持前端和后端一体化运行。
- minibridge backend：启动后端服务，暴露MCP服务器API。
- minibridge frontend：启动前端服务，支持多种通信模式。
- minibridge scan sbom：生成MCP服务器的SBOM文件。
- minibridge scan check：离线验证SBOM文件。
- minibridge scan dump：导出MCP服务器的所有工具、提示和资源。
常见问题解答
- 如何启用HTTPS：通过
--tls-server-cert和--tls-server-key参数配置。 - 如何集成Policer：通过
--policer-type和--policer-http-url或--policer-rego-policy参数配置。 - 如何验证SBOM：使用
minibridge scan check命令离线验证，或通过--sbom参数在线验证。
使用教程
使用依赖
- 确保已安装Node.js和npm。
- 安装
wscat工具用于WebSocket测试：
npm install -g wscat安装教程
- 安装Minibridge：
npm install -g minibridge- 启动All In One模式：
minibridge aio --listen :8000 -- npx @modelcontextprotocol/server-filesystem /tmp- 启动后端服务：
minibridge backend -- npx @modelcontextprotocol/server-filesystem /tmp- 启动前端服务：
minibridge frontend --listen :8081 --backend wss://127.0.0.1:8000/ws调试方式
- 测试All In One模式：
curl http://127.0.0.1:8000/sse
curl http://127.0.0.1:8000/message?sessionId=UID -X POST -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'- 测试后端服务：
wscat --connect ws://127.0.0.1:8000/ws- 测试前端服务：
curl http://127.0.0.1:8081/sse
curl http://127.0.0.1:8081/message?sessionId=UID -X POST -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'