網路設定

說明 KuraDB 如何選擇 HTTP port、何時掛載遠端 MCP endpoint，以及 client 如何取得目前的 URL。

HTTP port

config.json 目前支援兩個 property：

{
  "port": 8080,
  "remote": false
}

請透過 KuraDB 管理此值，不要手動編輯 JSON：

kura port set 8080
kura port clear

port set 會持久化設定、停止執行中的 daemon 並啟動新的 daemon；原本沒有 daemon 在跑時也會直接啟動。port clear 只重設 port（保留 remote 旗標），於下次手動啟動後生效。

未固定 port 時，KuraDB 會在 10000 到 65535 之間隨機嘗試最多 10 個 port。固定 port 已被占用時不會重試：HTTP listener 記錄錯誤後不啟動。固定與隨機 listener 都只綁定 127.0.0.1；發布的 URL 使用 localhost。

Remote MCP endpoint

HTTP listener 上的 MCP endpoint 需明確開啟：

kura remote enable
kura remote disable

兩個指令都會持久化 remote 旗標，且只在 daemon 執行中時重啟它，因為 route 是在啟動時掛載的。旗標為 false 時，daemon 照常提供 /api/*，而 /mcp 回 404。stdio transport（kura mcp）完全不受此設定影響。兩種 transport 的 client 設定見連接 MCP Client。

Endpoint discovery

Listener 就緒後，KuraDB 會將 URL 寫入 ~/.config/kuradb/endpoint：

BASE="$(cat ~/.config/kuradb/endpoint)"
curl "$BASE/api/health"

Launcher 會等待此檔案最多 10 秒，出現後印出 URL。Graceful shutdown 會將它移除，因此 consumer 應在每次重啟後重新讀取。