Kilonova MCP

Kilonova MCP

Claude Code 向けの永続ナレッジベースツールです。
Claude はプロジェクト、決定事項、パターンをセッションをまたいで記憶します。データはお使いのマシンに保存され、クラウドは不要です。

AIM Studio が開発 · 無料 · MIT License

---

課題

Claude Code のセッションは毎回、何も知らない状態から始まります。プロジェクトの構成を説明し直し、先週決めたことを再説明し、現在進行中の作業を伝え直す必要があります。コンテキストはすぐに消費されます。

解決策：DOT + KB

Kilonova は、お使いのマシン上に Claude 用の永続ナレッジベースを用意します。セッション開始時に、Claude はプロジェクトの状態、進行中のタスク、決定事項、パターンをまとめた、圧縮された構造化参照ドキュメントである DOT（Document of Truth）を読み込みます。セッション中、Claude は新たな発見を KB に書き戻します。次のセッションでは、その内容をすべて利用できます。

Session 1: Claude learns your architecture → kb_write saves the decision
Session 2: dot_load → Claude already knows. No recap needed.

---

インストール

pip install kilonova-mcp

ソースからインストールする場合：

git clone https://github.com/MilnaOS/kilonova-mcp
cd kilonova-mcp
pip install -e .

Claude Code の接続

~/.claude/settings.json に追加します：

{
  "mcpServers": {
    "kilonova": {
      "command": "python",
      "args": ["-m", "kilonova_mcp"],
      "env": {
        "KILONOVA_KB_ROOT": "/path/to/your/kb"
      }
    }
  }
}

CLAUDE.md.template を ~/.claude/CLAUDE.md にコピーするか、既存のファイルに追記します。

クイックスタート

1. 最初の KB トピックを作成します：

Claude Code で、次のように書き始めます：

mcp__kilonova__kb_write(
  topic="claude_context",
  entity_type="project_state",
  name="my-project",
  data={
    "name": "my-project",
    "status": "active",
    "location": "/path/to/project",
    "summary": "What this project is",
    "next_action": "What to do next"
  }
)

2. 次のセッションで読み込みます：

mcp__kilonova__dot_load(topic="claude_context")

3. 検索します：

mcp__kilonova__kb_search(topic="claude_context", query="authentication decision")

---

DOT 形式

DOT は、次の 3 つのセクションで構成されるプレーンテキストファイルです：

---SYMBOLS---
[PR]=My Project (/path/to/project)
[DB]=Database (PostgreSQL on localhost:5432)

---TOC---
1:Projects|1.1:My_Project
2:Active_Tasks
3:Decisions

---CARDS---

## [1] PROJECTS
### [1.1] My Project
STATUS: active
NEXT: wire up the auth flow

シンボルを使うと、繰り返し登場する参照を圧縮できます。TOC を使うと、Claude は必要なセクションだけを取得できます。カードには実際の内容を記載します。

スターターテンプレートは example_dot/ をご覧ください。

---

スタータースキーマ：claude_context

schemas/claude_context/ を、KB ディレクトリ内の <kb_root>/claude_context/schemas/ にコピーします：

エンティティタイプ	用途
project_state	プロジェクトごとの現在の状況、場所、次のアクション
decision	理由を添えたアーキテクチャ上の選択
pattern	コード規約、注意点、ファイルの場所
active_task	セッションをまたいで進行中の作業
session_note	セッション終了時の要約

---

ツール

ツール	説明
dot_load(topic)	DOT ドキュメント全体をコンテキストに読み込む
kb_search(topic, query)	自然言語のクエリでレコードを検索する
kb_write(topic, entity_type, name, data)	レコードを書き込む／更新する（既存の内容とマージ）
kb_load(topic, entity_type, name)	特定のレコードを 1 つ読み込む
kb_topics()	すべての KB トピックとレコード数を一覧表示する
kb_schema(topic, entity_type?)	エンティティタイプのフィールドスキーマを表示する
corpus_status(topic)	KB のサイズとレコード数を表示する
kb_backup(dry?)	KB を OneDrive にミラーリングする

---

独自の KB を使用する

Kilonova は、保存する内容を問いません。独自のスキーマを定義できます：

// kb/my_topic/schemas/component.json
{
  "name": {"type": "string", "description": "Component name"},
  "file": {"type": "string", "description": "Path to file"},
  "purpose": {"type": "string", "description": "What it does"},
  "dependencies": {"type": "array", "description": "What it depends on"}
}

その後、レコードを書き込んで自然な言葉で検索できます。

---

Kilonova エコシステムの一部

Kilonova MCP は、フル機能の BYOK マルチモデル AI ターミナルである Milna OS から切り出された、無料のスタンドアロン KB レイヤーです。並列モデル実行、蒸留エンジン、ウェブ取り込み、ローカルとクラウドのハイブリッド推論など、すべての機能を利用したい場合は、Milna OS をご覧ください。

---

MIT License · © AIM Studio