worldlydust/alpine-mcp repository overview

⁠alpine-mcp

Alpine 完全控制 MCP 沙箱 — Agent/客户端通过 MCP 协议在 Alpine 容器内执行任意 Shell 命令、读写文件、查询系统状态。无黑白名单限制，安全边界 = Docker 容器本身。

⁠快速开始

docker run -d --name alpine-sandbox -p 3100:3100 worldlydust/alpine-mcp:latest

⁠LobeHub 配置

⁠支持的连接方式

镜像支持 3 种传输模式，通过 --transport 参数切换。

⁠StreamableHTTP（默认）

docker run -d --name alpine-sandbox --network lobe-network -p 3100:3100 worldlydust/alpine-mcp:latest

客户端配置： Streamable HTTP → http://alpine-sandbox:3100/mcp

协议：

• POST /mcp 首次请求带 Accept: application/json, text/event-stream
• 响应头 MCP-Session-Id 返回 session ID
• 后续请求加 MCP-Session-Id 头
• 请求间不要求长连接，每个请求独立

⁠SSE

docker run -d --name alpine-sandbox -p 3100:3100 \
  worldlydust/alpine-mcp:latest \
  python /opt/mcp_server.py --transport sse --port 3100

客户端配置： SSE → http://alpine-sandbox:3100/sse

协议：

• GET /sse 建立长连接 SSE 流
• POST /messages/?session_id=xxx 发送请求
• 响应通过 SSE 流推送回来

⁠Stdio

docker run -d --name alpine-sandbox worldlydust/alpine-mcp:latest sleep infinity

Hermes Agent 配置：

mcp_servers:
  alpine-sandbox:
    command: docker
    args: ["exec", "-i", "alpine-sandbox", "python", "/opt/mcp_server.py", "--transport", "stdio"]

JSON-RPC over stdin/stdout。

⁠工具

⁠参数

⁠安全

完整控制权限，无黑白名单。安全边界 = Docker 容器重启。