bolor-brain-mcp

Bolor Brain MCP

Claude Code のための純粋な知能。 推論、記憶、学習――それ以外は何もありません。

---

これは何ですか？

Bolor Brain は、Claude Code に頭脳を与える MCP サーバーです。構造化された推論、永続的な記憶、経験からの学習を提供します。

User --> Claude Code (Gateway + Executor)
              |
         +----+----+
    Bolor Brain   NSAF
      (MCP)       (MCP)
      THINK       EVOLVE

• Claude Code = ゲートウェイ + ツール実行 + セッション + 権限
• Bolor Brain = 推論エンジン + 記憶 + 学習 + 永続化
• NSAF = 戦略の進化 + 自己改善（独立した MCP サーバー）

Bolor Brain は何も実行しません。ファイル操作、スケジューリング、自律的なループはありません。これらはすべて Claude Code がすでに行います。Bolor Brain は思考だけを行います。

---

クイックスタート

1. インストール

git clone https://github.com/photoxpedia/bolor-brain-mcp.git
cd bolor-brain-mcp
pip install -e .

2. Claude Code の設定

~/.claude/mcp-config.json に追加します。

{
  "mcpServers": {
    "bolor-brain": {
      "command": "python",
      "args": ["-m", "mcp_server"],
      "cwd": "/path/to/bolor-brain-mcp"
    }
  }
}

3. 使用方法

/reason Why is Python popular for data science?
/debug API returns 500 errors under load
/decide PostgreSQL or MongoDB for our app?
/learn-from We fixed the memory leak by increasing connection pool

---

MCP ツール（11 個）

推論（6 個）

ツール	機能
reason_hybrid	あらゆるクエリに最適な推論方法を自動選択します
reason_symbolic	事実とルールによる前向き・後ろ向き連鎖推論を行います
reason_knowledge_graph	グラフ探索、経路検索、関係性の調査を行います
reason_case_based	過去の類似問題とその解決策を見つけます
reason_hypothesis	観察結果から仮説を生成し、検証します
reason_analogical	異なる領域間でパターンを転用します（原子 ～ 太陽系）

記憶（4 個）

ツール	機能
remember	ケース、事実、ノード、またはエッジを保存します
recall	一致するケースまたは事実を取得します
learn	問題／解決策／結果を保存します（remember のショートカット）
forget	ID を指定してケースまたは事実を削除します

ユーティリティ（1 個）

ツール	機能
brain_stats	ケース、事実、ノード、エッジの件数を表示します

---

スキル（6 個）

スキル	使用する場面
/reason	あらゆる複雑な問題を深く分析するとき
/debug	仮説検証によって体系的にバグを探すとき
/decide	エビデンスに基づいて技術的な判断を行うとき
/learn-from	今後に活用する経験を保存するとき
/nsaf	NSAF の進化機能を統合するとき（NSAF MCP が必要）
/orchestrate	Bolor Brain と NSAF を組み合わせてメタオーケストレーションを行うとき

---

永続化

脳の状態は JSON として ~/.bolor-brain/ に永続化されます。

~/.bolor-brain/
  cases.json       # Problem -> solution -> outcome
  facts.json       # Symbolic reasoning facts
  knowledge.json   # Knowledge graph (nodes + edges)

知識は時間とともに蓄積されます。バグを一度解決すれば、次回は解決策をすぐに呼び出せます。

---

NSAF との連携

進化機能を利用するには、NSAF を追加します。

{
  "mcpServers": {
    "bolor-brain": {
      "command": "python",
      "args": ["-m", "mcp_server"],
      "cwd": "/path/to/bolor-brain-mcp"
    },
    "nsaf": {
      "command": "python3",
      "args": ["nsaf_mcp_server.py"],
      "cwd": "/path/to/nsaf",
      "env": { "PYTHONPATH": "/path/to/nsaf" }
    }
  }
}

連携すると、Bolor Brain が何をするかを推論し、NSAF がその方法を改善し、Claude Code が実行します。

連携ワークフローについては、skills/nsaf.md および skills/orchestrate.md を参照してください。

---

テスト

pytest tests/ -v
# 376 tests

---

プロジェクト構成

mcp_server.py                    # MCP server (11 tools)
persistence.py                   # JSON persistence to ~/.bolor-brain/
modules/
  config.py                      # Configuration
  reasoning_engines/
    symbolic_reasoner.py          # Forward/backward chaining
    knowledge_graph.py            # Graph-based knowledge
    case_based_reasoner.py        # 4R cycle (retrieve, reuse, revise, retain)
    hypothesis_engine.py          # Hypothesis generation and testing
    analogical_reasoner.py        # Cross-domain pattern transfer
    hybrid_reasoner.py            # Orchestrates all 5 engines
skills/                          # Claude Code skills
  reason.md, debug.md, decide.md, learn-from.md, nsaf.md, orchestrate.md
tests/                           # 376 tests
AGENT_GUARDRAILS.md              # Production safety guidelines

---

作者

Bolorerdene Bundgaa

• ウェブサイト：bolor.me
• メール：[email protected]

ライセンス

MIT -- LICENSE を参照