跳到主要内容

arc serve

arc serve 通过 HTTP 或 MCP 启动一个 AFS 服务，让 CLI 之外的东西（浏览器、agent、MCP 客户端）能通过网络和你的 AFS 实例对话，不用再走 CLI。

用法

bash
arc serve [options]

全局选项（见 总览）：--json、--view、--instance / -i（作用在哪个本地 ARC 实例；省略即 default），以及 --home（实例根；要指定作用在哪个实例，用 --instance）。

  • --host <host>：绑定的主机（默认 localhost）
  • --port <port>：监听端口（默认 3000）
  • --path <path>：API 的基础路径（默认 /afs）
  • --readonly：只读模式
  • --cors：开启 CORS；不带值就是关闭，* 表示任意来源，也可以传逗号分隔的白名单
  • --transport <http|mcp-stdio|mcp-http>：传输方式（默认 http）。mcp-http 设计上只用于本地开发，没有 Bearer token 支持
  • --token <token>：要求每次请求带 Bearer token；覆盖 config 里的 serve.token
  • --insecure-no-auth：绑定到非本地地址时明确不启用鉴权。危险：任何能连到这个地址的人都能拿到完整 AFS 权限

这和 arc service 不一样，后者管理具名的长期后台实例。arc serve 是给单次会话用的前台进程。见 arc service。

示例

bash
$ arc serve --port 4000 --cors '*'
AFS HTTP Server starting...
Mounted providers:
  ...

Listening on: http://localhost:4000/afs
Press Ctrl+C to stop