Bolor Brain Mcp

io.github.photoxpediaPublished by GitHub account photoxpediav1.1.0Updated Oct 24, 2026

Cognitive architecture MCP server with memory, learning, and contextual understanding

The publisher's own server: BrainDog

VerifiedSTDIODesktop onlyKnowledge & MemoryAI & ML

Overview

AI-generated overview

A local MCP server that gives an assistant structured reasoning engines plus persistent memory and learning, stored as JSON on the user's machine.

What you can do
Run six reasoning approaches: hybrid auto-selection, symbolic chaining, knowledge-graph traversal, case-based matching, hypothesis testing and analogical transfer, plus a stats tool for counts of stored cases, facts, nodes and edges. Store, retrieve and delete cases, facts and knowledge-graph nodes or edges, and record problem/solution/outcome experiences for later recall. Persist brain state to a local directory so solved problems can be recalled in later sessions.
When to use it
Useful when you want an assistant to reason through complex problems, debug systematically or make evidence-based technical decisions, and to accumulate reusable cases and facts across sessions. It is a thinking layer only, so pair it with an assistant that already handles files and execution.
Requirements
Runs as a local stdio process; the README installs it from a cloned repository with pip and configures it as a Python module, while the manifest lists an npm package run with npx. Optional environment variables BRAIN_LOG_LEVEL and BRAIN_USE_SQLITE. No authentication declared.
Before you install
It writes persistent state to a local directory on your machine, and the forget tool deletes stored cases or facts by ID. The README's install steps clone and install code from a third-party repository, so review it before running. No credentials are requested.

Installation

In SourceWeft

  1. Open Bolor Brain Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Bolor Brain MCP

Pure intelligence for Claude Code. Reasoning, memory, and learning -- nothing else.

[License: MIT] [Python 3.11+] [MCP Compatible]

What Is This?

Bolor Brain is an MCP server that gives Claude Code a brain: structured reasoning, persistent memory, and learning from experience.

User --> Claude Code (Gateway + Executor)              |         +----+----+    Bolor Brain   NSAF      (MCP)       (MCP)      THINK       EVOLVE
  • Claude Code = Gateway + tool execution + sessions + permissions
  • Bolor Brain = Reasoning engines + memory + learning + persistence
  • NSAF = Strategy evolution + self-improvement (separate MCP server)

Bolor Brain does NOT execute anything. No file ops, no scheduling, no autonomous loop. Claude Code already does all of that. Bolor Brain only thinks.

Quick Start

1. Install

bash
git clone https://github.com/photoxpedia/bolor-brain-mcp.gitcd bolor-brain-mcppip install -e .

2. Configure Claude Code

Add to ~/.claude/mcp-config.json:

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

3. Use

/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 Tools (11)

Reasoning (6)

ToolWhat It Does
reason_hybridAuto-selects best reasoning approach for any query
reason_symbolicForward/backward chaining with facts and rules
reason_knowledge_graphGraph traversal, path finding, relationship exploration
reason_case_basedFind similar past problems and their solutions
reason_hypothesisGenerate and test hypotheses from observations
reason_analogicalCross-domain pattern transfer (atom ~ solar system)

Memory (4)

ToolWhat It Does
rememberStore a case, fact, node, or edge
recallRetrieve matching cases or facts
learnStore problem/solution/outcome (shortcut for remember)
forgetDelete a case or fact by ID

Utility (1)

ToolWhat It Does
brain_statsCases, facts, nodes, edges count

Skills (6)

SkillWhen To Use
/reasonDeep analysis of any complex problem
/debugSystematic bug hunting with hypothesis testing
/decideEvidence-based technical decisions
/learn-fromStore experiences for future use
/nsafNSAF evolution integration (requires NSAF MCP)
/orchestrateMeta-orchestration combining Bolor Brain + NSAF

Persistence

Brain state persists to ~/.bolor-brain/ as JSON:

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

Knowledge compounds over time. Solve a bug once, recall the solution instantly next time.

With NSAF

Add NSAF to get evolution capabilities:

json
{  "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" }    }  }}

Together: Bolor Brain reasons about WHAT to do. NSAF evolves HOW to do it better. Claude Code executes.

See skills/nsaf.md and skills/orchestrate.md for combined workflows.

Testing

bash
pytest tests/ -v# 376 tests

Project Structure

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 enginesskills/                          # Claude Code skills  reason.md, debug.md, decide.md, learn-from.md, nsaf.md, orchestrate.mdtests/                           # 376 testsAGENT_GUARDRAILS.md              # Production safety guidelines

Author

Bolorerdene Bundgaa

License

MIT -- see LICENSE

Source: README.md at commit d798c20

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Brain integrations

BrainDog

dog.brainOfficial publisher

BrainDog is a hosted record of projects, decisions and money that connected AI agents read before starting work and write their results into.

Streamable HTTPWeb executableAuth
FinanceCredential requiredNov 5, 2026

Codebase Brain

Published by GitHub account Nomannazir

Indexes a local or public git codebase so an assistant can search it, trace git history, check change impact and find stale docs, all with path:line citations.

STDIODesktop only
Developer ToolsNot validated yetNov 7, 2026

Personal Brain

Published by GitHub account zhang-liz

Gives an AI assistant memory of your professional network, stored as a graph in FalkorDB, so it can look up contacts, find people by topic, and save who you…

STDIODesktop only
Databases3 toolsNov 6, 2026

Second Brain

Published by GitHub account ara-5

Shared Graph-RAG memory for AI agents: markdown vault, wikilink recall, tasks, messaging.

STDIODesktop only
AI & ML12 toolsNov 7, 2026

Make0 Brain

Published by GitHub account make0-official

Local, offline memory server that gives Claude Code, Cursor, Codex and other MCP agents one shared, versioned store of durable facts.

STDIODesktop only
AI & MLNot validated yetNov 7, 2026