AI エージェント (MCP)

kura は、AI エージェントの長期記憶になるよう設計されています。stdio 経由で Model Context Protocol を 話すため、エージェントは通常のツール利用の一部として、ナレッジベースを 検索し、そこに書き込めます。

Claude Code に接続する

claude mcp add kura -- kura mcp

ほかの MCP クライアントには、すぐ使える設定スニペットを出力できます。

kura mcp --print-config     # .mcp.json 用のエントリを表示

あとは kura mcp を実行するだけです。stdio で動き、ローカルに閉じて います。ネットワークもアカウントも要りません。

公開ツール

ツール	目的
kura_query	ハイブリッド検索（キーワード + セマンティック + リランク）。既定の検索ツール
kura_ask	ノートを根拠に質問へ回答。出典付き
kura_search	キーワード検索（FTS5 BM25）
kura_get	key・フルパス（clips/タイトル）・タイトルでドキュメントを取得
kura_add	ドキュメントを作成。任意の path でフォルダ風のドキュメント path 配下に置ける
kura_update	既存ドキュメントを更新。title / path の変更は参照元の [[リンク]] を書き換え
kura_list_tags	タグ階層を一覧
kura_related	指定ドキュメントに関連するドキュメント（アウトリンク・バックリンク・2 ホップリンク）
kura_changes	指定時点以降の変更一覧（7d や日付）。リネームや移動も検出
kura_status	ストアの統計

エージェントは通常、セッションの最初に kura_changes で前回からの 変更に追いつき、文脈を思い出すために kura_query を（出典付きの回答が 欲しいときは kura_ask を）、ヒットの周辺を探るために kura_related を、発見を書き戻すために kura_add / kura_update を使います。kura は セッションをまたぐ永続的な記憶になります。

劣化動作

MCP ツールは CLI と同じ規則に従います。kura_search と kura_changes は LLM プロバイダが無くても動き、kura_query はセマンティック検索や リランクが利用できないときはキーワード結果側へフォールバックし、 kura_ask は回答の代わりに検索結果を返します （検索 を参照）。モデルが動いていないという理由 だけで、エージェントがハードな失敗を受け取ることはありません。

どこでも --json

MCP ではなくスクリプトで kura を扱いたい場合、すべての読み取り コマンドは --json に対応します。

kura query "SQLite の並行性" --json
kura get "今日のメモ" --json
kura status --json

JSON の形は安定した契約です（MCP ツールを支えるのと同じペイロード です）。安心して上に積み上げられます。