跳到主要內容

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