Litestream MCP 先开 mcp-addr,再连 localhost:3001

官方 Codex:mcp add litestream --url http://localhost:3001。先在 litestream.yml 写 mcp-addr,再 litestream replicate。没有 litestream mcp 子命令。不要 mcp login,也不要抄 Claude 的 --transport http。

Litestream 给 Codex 的官方节就是这一条:

codex mcp add litestream --url http://localhost:3001

URL 没有 /mcp 后缀,协议是 http 不是 https。这是本机 Streamable HTTP,不要 codex mcp login:官方写明 MCP 没有内建鉴权。不要抄 Claude 的 --transport http,也不要抄 Cursor / Claude Desktop 的 mcpServers JSON。

MCP 不是单独进程。没有 litestream mcp 子命令,也没有等价 CLI 旗标。要先在 Litestream 自己的 YAML 里开 mcp-addr(0.5.0 起),再跑 replicate:

mcp-addr: "127.0.0.1:3001"
litestream replicate -config litestream.yml

日志里应出现 Starting MCP Streamable HTTP server。只绑回环,不要写成 0.0.0.0。不要把这台暴露到公网。远程访问官方建议 SSH 隧道或反向代理;Fly.io 的 flyctl mcp proxy --stream 是给 Claude Desktop 的 stdio 包装,不要当 Codex 主路径。

[mcp_servers.litestream]
url = "http://localhost:3001"
enabled = true

先让 Litestream 起来,再开 Codex。连上后可问状态(litestream_info / litestream_databases / litestream_status),列恢复点(litestream_ltx)。litestream_restorelitestream_reset 会动库,保持工具批准。不要一上来 --yolo。不要给它 required = true 挂全局。

GitHub 上的 Agent Skill 还是提案,不要发明 npx skills addcodex plugin add litestream@…

不要做这些:

  • 不要抄 claude mcp add litestream --transport http
  • 不要发明 https://localhost:3001/mcp
  • 不要把 Fly.io 的 flyctl mcp proxy JSON 抄进 Codex。
  • 不要给它 required = true 挂全局。

网页 Cloud 够不到你笔记本上的 3001。改完新开会话。用 codex mcp get litestream 看传输是 streamable_http。

来源