# 設定

KuraDB 從 `~/.config/kuradb/config.json` 讀取的設定，以及修改它們的指令。

## config.json

此檔為選用；不存在即全部使用預設值。由 CLI 以縮排格式寫入，daemon 啟動時讀取一次。

```json
{
  "port": 23456,
  "remote": true
}
```

| 鍵 | 型別 | 預設 | 設定方式 | 效果 |
|---|---|---|---|---|
| `port` | integer | 省略：10000 到 65535 的隨機連接埠 | `kura port set <port>`／`kura port clear` | `127.0.0.1` 上的固定 HTTP 連接埠 |
| `remote` | boolean | `false` | `kura remote enable`／`kura remote disable` | 在 `/mcp` 以 HTTP 掛載 MCP |

值為零值的欄位不會寫進檔案。檔案存在但無法解析時，daemon 記錄警告並使用預設值。

## 變更生效時機

| 變更 | 生效 |
|---|---|
| `kura port set <port>` | 立即；daemon 會停止再啟動（原本沒有執行也會啟動） |
| `kura port clear` | 下次手動重啟（`kura stop` 後執行 `kura`） |
| `kura remote enable`／`disable` | daemon 執行中時立即生效；否則下次啟動生效 |
| `kura add <name>` | 下次 daemon 啟動；資料庫不會熱載入 |

`kura mcp` 程序在啟動時讀取 `db.json`，新增資料庫後請重啟 MCP client。

## 環境變數

KuraDB 不讀取任何環境變數。所有狀態都位於從使用者家目錄解析出的 `~/.config/kuradb/` 下；見[資料配置](/zh/data-layout)。

## 相關頁面

- [Daemon 生命週期](/zh/daemon)
- [MCP 伺服器](/zh/mcp-server)