Thebrain

Name: Thebrain
Author: yBookoff

von yBookoffVersion 0.3.0i★ 8iLäuft auf deinem Computer

Name in der Registryio.github.yBookoff/thebrain

So installierst du es

Überblick

Beschreibung vom Entwickler (englisches Original)

MCP server for TheBrain 15: search by meaning, graph traversal and batch writes over the local API

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Suche & KI-Gedächtnis
Das musst du eintragen: THEBRAIN_API_KEY

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

2/2 Prüfungen bestanden · Läuft auf deinem Computer

Zuerst: Welche KI nutzt du?

ClaudeWeb · App · HandyChatGPTWebClaude CodeTerminalCursorCode-EditorVS CodeCode-EditorAndereAndere Apps

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Thebrain (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Node.js installieren
Nur einmal; gilt für alle Server, die Node.js brauchen
Download-Seite von Node.js öffnen ↗
Erledigt
Bei Thebrain registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Kann Geld kosten.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Erledigt
Einstellungsdatei der Claude-Desktop-App öffnen
SettingsDeveloperEdit Config
Erledigt

Diese Einstellungen einfügen und speichern

{
  "mcpServers": {
    "thebrain": {
      "command": "npx",
      "args": [
        "-y",
        "thebrain-mcp-server"
      ],
      "env": {
        "THEBRAIN_API_KEY": "your-value",
        "THEBRAIN_BASE_URL": "your-value",
        "THEBRAIN_DATA_DIR": "your-value",
        "THEBRAIN_ALLOW_DESTRUCTIVE": "your-value",
        "THEBRAIN_EMBEDDING_MODEL": "your-value",
        "THEBRAIN_EMBEDDING_DTYPE": "your-value",
        "THEBRAIN_TIMEOUT_MS": "your-value"
      }
    }
  }
}

Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

Erledigt

Claude beenden und neu öffnen
Erledigt
Ausprobieren
Nutze Thebrain und sag mir, was du für mich tun kannst; zeig mir dann eine Sache
✓ Wenn Claude sagt, dass es Thebrain nutzt, oder ein Werkzeug von Thebrain in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Thebrain noch nicht verbinden

Thebrain läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die Thebrain verbinden kann

Schritte für Claude →Du brauchst einen Schlüssel von Thebrain (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
Schritte für Claude Code →Du brauchst einen Schlüssel von Thebrain (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Schritte für Cursor →Du brauchst einen Schlüssel von Thebrain (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Schritte für VS Code →Du brauchst einen Schlüssel von Thebrain (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

B · Andere in Suche & KI-Gedächtnis, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

AIHOT✓ ChatGPT
Sui Knowledge Base (kapa.ai)✓ ChatGPT
Exa✓ ChatGPT

Klappt mit Claude Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Thebrain (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Node.js installieren
Nur einmal; gilt für alle Server, die Node.js brauchen
Download-Seite von Node.js öffnen ↗
Erledigt
Bei Thebrain registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Kann Geld kosten.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Erledigt
Terminal öffnen
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
Erledigt

Diesen Befehl einfügen und Enter drücken

claude mcp add thebrain --env THEBRAIN_API_KEY=your-value --env THEBRAIN_BASE_URL=your-value --env THEBRAIN_DATA_DIR=your-value --env THEBRAIN_ALLOW_DESTRUCTIVE=your-value --env THEBRAIN_EMBEDDING_MODEL=your-value --env THEBRAIN_EMBEDDING_DTYPE=your-value --env THEBRAIN_TIMEOUT_MS=your-value -- npx -y thebrain-mcp-server

Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

Erledigt

/mcp in Claude Code eingeben
Thebrain sollte in der Liste als verbunden erscheinen
Erledigt
Ausprobieren
Nutze Thebrain und sag mir, was du für mich tun kannst; zeig mir dann eine Sache
✓ Wenn Claude Code sagt, dass es Thebrain nutzt, oder ein Werkzeug von Thebrain in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Thebrain (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Node.js installieren
Nur einmal; gilt für alle Server, die Node.js brauchen
Download-Seite von Node.js öffnen ↗
Erledigt
Bei Thebrain registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Kann Geld kosten.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Erledigt
Mit diesem Button Cursor öffnen
In Cursor öffnen
Cursor fragt nach einer Bestätigung; klicke Install
Erledigt
Schlüssel eintragen
In den Einstellungen von Thebrain ist THEBRAIN_API_KEY, THEBRAIN_BASE_URL, THEBRAIN_DATA_DIR, THEBRAIN_ALLOW_DESTRUCTIVE, THEBRAIN_EMBEDDING_MODEL, THEBRAIN_EMBEDDING_DTYPE, THEBRAIN_TIMEOUT_MS leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Erledigt
KI-Chat in Cursor im Agent-Modus öffnen
Erledigt
Ausprobieren
Nutze Thebrain und sag mir, was du für mich tun kannst; zeig mir dann eine Sache
✓ Wenn Cursor sagt, dass es Thebrain nutzt, oder ein Werkzeug von Thebrain in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Thebrain (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Node.js installieren
Nur einmal; gilt für alle Server, die Node.js brauchen
Download-Seite von Node.js öffnen ↗
Erledigt
Bei Thebrain registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Kann Geld kosten.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Erledigt
Mit diesem Button VS Code öffnen
In VS Code öffnen
VS Code fragt nach einer Bestätigung; klicke Install
Erledigt
Schlüssel eintragen
In den Einstellungen von Thebrain ist THEBRAIN_API_KEY, THEBRAIN_BASE_URL, THEBRAIN_DATA_DIR, THEBRAIN_ALLOW_DESTRUCTIVE, THEBRAIN_EMBEDDING_MODEL, THEBRAIN_EMBEDDING_DTYPE, THEBRAIN_TIMEOUT_MS leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Erledigt
KI-Chat in VS Code im Agent-Modus öffnen
Erledigt
Ausprobieren
Nutze Thebrain und sag mir, was du für mich tun kannst; zeig mir dann eine Sache
✓ Wenn VS Code sagt, dass es Thebrain nutzt, oder ein Werkzeug von Thebrain in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Thebrain nutzen💬 Diskussion →

Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Auf deinem Computer installiert

Claude Code

claude mcp add thebrain --env THEBRAIN_API_KEY=your-value --env THEBRAIN_BASE_URL=your-value --env THEBRAIN_DATA_DIR=your-value --env THEBRAIN_ALLOW_DESTRUCTIVE=your-value --env THEBRAIN_EMBEDDING_MODEL=your-value --env THEBRAIN_EMBEDDING_DTYPE=your-value --env THEBRAIN_TIMEOUT_MS=your-value -- npx -y thebrain-mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "thebrain": {
      "command": "npx",
      "args": [
        "-y",
        "thebrain-mcp-server"
      ],
      "env": {
        "THEBRAIN_API_KEY": "your-value",
        "THEBRAIN_BASE_URL": "your-value",
        "THEBRAIN_DATA_DIR": "your-value",
        "THEBRAIN_ALLOW_DESTRUCTIVE": "your-value",
        "THEBRAIN_EMBEDDING_MODEL": "your-value",
        "THEBRAIN_EMBEDDING_DTYPE": "your-value",
        "THEBRAIN_TIMEOUT_MS": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "thebrain": {
      "command": "npx",
      "args": [
        "-y",
        "thebrain-mcp-server"
      ],
      "env": {
        "THEBRAIN_API_KEY": "your-value",
        "THEBRAIN_BASE_URL": "your-value",
        "THEBRAIN_DATA_DIR": "your-value",
        "THEBRAIN_ALLOW_DESTRUCTIVE": "your-value",
        "THEBRAIN_EMBEDDING_MODEL": "your-value",
        "THEBRAIN_EMBEDDING_DTYPE": "your-value",
        "THEBRAIN_TIMEOUT_MS": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "thebrain": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "thebrain-mcp-server"
      ],
      "env": {
        "THEBRAIN_API_KEY": "your-value",
        "THEBRAIN_BASE_URL": "your-value",
        "THEBRAIN_DATA_DIR": "your-value",
        "THEBRAIN_ALLOW_DESTRUCTIVE": "your-value",
        "THEBRAIN_EMBEDDING_MODEL": "your-value",
        "THEBRAIN_EMBEDDING_DTYPE": "your-value",
        "THEBRAIN_TIMEOUT_MS": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

THEBRAIN_API_KEY geheim erforderlich env
Local API key from TheBrain: Settings > User > Local API Key
THEBRAIN_BASE_URL env
Address of the local API. Default http://localhost:11522, then http://localhost:8001 for older TheBrain builds
THEBRAIN_DATA_DIR env
Where semantic indexes are stored. Default ~/.thebrain-mcp
THEBRAIN_ALLOW_DESTRUCTIVE env
Set to 1 to allow deleting thoughts. Deletion still requires human confirmation. Default 0
THEBRAIN_EMBEDDING_MODEL env
Embedding model for semantic search. Default Xenova/multilingual-e5-small
THEBRAIN_EMBEDDING_DTYPE env
Weight precision: fp32, fp16, q8 or q4. Default q8
THEBRAIN_TIMEOUT_MS env
API request timeout in milliseconds. Default 30000

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

GitHub-Sterne i: 8
Downloads pro Wochei: 84/Wo.
Lizenz i: Keine Lizenz angegeben
Verbindung: Läuft auf deinem Computer
Transport: stdio
Neueste Versioni: 0.3.0
Kategoriei: Suche & KI-Gedächtnis
In der Registry veröffentlichti: 15. Okt. 2026
Code zuletzt geänderti: 15. Okt. 2026
Entwickler: yBookoff
Pakete: npm: thebrain-mcp-server
Repo: yBookoff/thebrain-mcp
Registry-Status: Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 11. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto yBookoff bestätigt, dem das Repo gehört
✓ Bestanden
Wird noch gepflegt
Code zuletzt geändert: vor 27 Tagen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Mit Google anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Mit Google anmelden, um zu bewerten

Im Vergleich mit anderen in Suche & KI-Gedächtnisi

Mehr Sterne als 91 % der anderen 5875 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 58 % der anderen 5875 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 5875 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Thebrain sicher?

Er hat 2 von 2 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: THEBRAIN_API_KEY

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 27 Tagen geändert, und die neueste Version (0.3.0) kam vor 27 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Ruflo, Context7, Metabase

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Ruflo

Agent teams, swarms, memory and hooks for Claude Code and Codex, served over MCP.

von ruvnetWeit verbreitet↓ 74.273/Wo.★ 81.393Aktualisiert heute

Läuft auf deinem Computer

Installieren

Context7

Up-to-date docs for AI agents

von upstashWeit verbreitet↓ 1,2 Mio./Wo.★ 64.447Aktualisiert gestern

Computer oder Cloud

Installieren

Metabase

Lets AI clients search, explore, query, and visualize data in a Metabase instance.

von metabaseWeit verbreitet★ 50.256Aktualisiert vor 6 Monaten

Läuft in der Cloud

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

thebrain-mcp

An MCP server for TheBrain 15, built on its local API.

It gives an agent semantic operations over your brain: search by meaning, read a neighbourhood of the graph, and write a decomposed piece of material into the brain as a whole connected structure. It is not a mirror of the API — 19 tools instead of 48 endpoints.

The point is not "save this text". The point is that when you hand an agent an article, it reads it, breaks it into meanings, works out where each one belongs in the graph you already have, what to link it to, and what each note should say.

Published on npm as `thebrain-mcp-server` — npm considers the shorter name

too close to an unrelated existing package. The installed command is still

thebrain-mcp.

Requirements

TheBrain 15 running, with the local API enabled
Node.js 22 or newer
An API key: Settings → User → Local API Key

Install

Claude Code

claude mcp add thebrain -e THEBRAIN_API_KEY=your-key -- npx -y thebrain-mcp-server

Clients with a config file

"mcpServers": { "thebrain": { "command": "npx", "args": ["-y", "thebrain-mcp-server"], "env": { "THEBRAIN_API_KEY": "your-key" } } } }

Semantic search

TheBrain's own search matches prefixes: OT finds OTGP, while a synonym or a typo finds nothing. To search by meaning, the server builds a local vector index.

The embeddings package is not part of the install: it weighs around 380 MB, plus 113 MB for the model itself on first run. Install it separately, and only if you want it:

npm install -g @huggingface/transformers

Then, from your client: brain_index with action: "rebuild". Indexing a 10,000-thought brain takes about a minute; later runs only recompute what changed.

The server works without the package. brain_search falls back to a fan-out of prefix queries over the synonyms the agent supplies, and says plainly that recall is lower.

Everything is local: neither your brain's contents nor your queries are sent anywhere.

Settings

Variable	Default	Purpose
`THEBRAIN_API_KEY`	—	Required
`THEBRAIN_BASE_URL`	`http://localhost:11522`, then `:8001`	Local API address
`THEBRAIN_DATA_DIR`	`~/.thebrain-mcp`	Where indexes are stored
`THEBRAIN_ALLOW_DESTRUCTIVE`	`0`	Allow deleting thoughts and links
`THEBRAIN_EMBEDDING_MODEL`	`Xenova/multilingual-e5-small`	Embedding model
`THEBRAIN_EMBEDDING_DTYPE`	`q8`	Weight precision
`THEBRAIN_TIMEOUT_MS`	`30000`	API request timeout

Changing the model or the precision makes an existing index unusable — the server will say so and ask for a rebuild.

THEBRAIN_BASE_URL rarely needs setting. A TheBrain update moved the local API from port 8001 to 11522, so the server tries the new port and falls back to the old one. Set the variable only if TheBrain listens somewhere else; the endpoint exactly as Settings shows it (http://localhost:11522/api/) is fine.

Tools

Reading

Tool	What it does
`brain_list`	Brains, which one is open, whether the index is ready
`brain_get_thought`	A thought, its aliases, its graph and its note in one call
`brain_search`	Search by meaning
`brain_traverse`	Walk the graph several hops out
`brain_list_types_and_tags`	The brain's vocabulary
`brain_recent_changes`	What changed, in plain language
`brain_index`	Index status, build and refresh

Writing

Tool	What it does
`brain_create_thought`	A thought together with its note, type, tags and aliases
`brain_update_thought`	Name, label, type, colours; add and remove aliases
`brain_set_note` / `brain_append_note`	Replace or extend a note
`brain_link`	Connect two thoughts, with a label; with `replace`, make the link that joins them another kind
`brain_unlink`	Remove a link, with human confirmation
`brain_tag`	Attach and detach tags
`brain_create_type_or_tag`	A new type or tag; a tag of a name the brain has is given back, not made twice
`brain_attach_url`	Attach a link, without duplicates
`brain_activate`	Open a thought on the user's screen
`brain_delete_thought`	Delete, with human confirmation
`brain_ingest`	Write a whole structure in one call

`brain_ingest`

The main tool for filling a brain. The agent breaks material into thoughts, wires them together through temporary identifiers, and the whole thing lands in one call:

"brainId": "…", "thoughts": [ { "tempId": "art", "name": "Article on RAG", "parent": " " }, { "tempId": "embed", "name": "Embeddings", "parent": "art", "note": "…" }, { "tempId": "store", "name": "Vector store", "parent": "art" } ], "links": [ { "from": "embed", "to": "store", "name": "is written into" } ] }

The order of thoughts in the input does not matter — dependencies resolve themselves. Running the same plan twice duplicates nothing, and a thought that was already there keeps the note it has: a plan's note is written only where there is none, and the result says which notes were kept. Bad plans (a cycle, a reference to nowhere) are rejected before the first write.

Skills

The server provides the mechanism — deterministic operations. The methodology (how finely to split meanings, when to attach to something that already exists, what belongs in a note) lives separately, in Claude Code skills. They are plain markdown files, so you can adjust them to your own way of working without rebuilding the server.

Skill	When it fires
`thebrain-ingest`	"put this article in my brain", "break this down and record it"
`thebrain-research`	"what do I know about X", "have we discussed this already?"
`thebrain-organize`	"clean up my brain", "find duplicates"
`thebrain-digest`	"what did I add this week", "what have I been working on"

Install them as symlinks, so edits in the repository take effect immediately:

mkdir -p ~/.claude/skills

for d in skills/*/; do ln -sfn "$PWD/$d" ~/.claude/skills/"$(basename "$d")" done

Or copy them, if you do not want the link to the repository. For a single project, use .claude/skills in its root instead of ~/.claude/skills.

Skills are picked up when a session starts — an already running session needs a restart (claude --continue keeps the conversation).

Deletion

Of a thought (brain_delete_thought) and of a link (brain_unlink). Off by default. Even with THEBRAIN_ALLOW_DESTRUCTIVE=1 it requires human consent: through a confirmation form if the client supports one, otherwise through a second call with an explicit flag. The agent cannot make this decision for you.

Development

npm install

npm test # unit tests, no live TheBrain needed npm run build

Contract tests against a live API:

THEBRAIN_API_KEY=… npm test                                  # read-only

THEBRAIN_API_KEY=… THEBRAIN_TEST_BRAIN_ID= npm test # + writes

The write tests require a separate, throwaway brain and refuse to touch any brain with more than 500 thoughts. The read-only tests that need a brain read that one too, and skip without it: no test reads another brain.

Documentation

ARCHITECTURE.md — how the server is built and why: layer boundaries, the mechanism/policy split, error philosophy, the semantic layer, and the reasons behind each decision.
docs/api-map.md — the local API's behaviour, including the undocumented parts, verified against a live instance, with the measurements.
docs/stack-evaluation.md — why TypeScript, with numbers.
CONTRIBUTING.md — how to work on this.

Support

thebrain-mcp is built and maintained in spare time. If it earns a place in your workflow, you can sponsor it on GitHub — once or monthly.

License

MIT

Thebrain

Überblick

Was du damit machen kannst

Installation

Node.js installieren

Bei Thebrain registrieren und Schlüssel erstellen

Einstellungsdatei der Claude-Desktop-App öffnen

Diese Einstellungen einfügen und speichern

Claude beenden und neu öffnen

Ausprobieren

Das kannst du stattdessen tun

Node.js installieren

Bei Thebrain registrieren und Schlüssel erstellen

Terminal öffnen

Diesen Befehl einfügen und Enter drücken

/mcp in Claude Code eingeben

Ausprobieren

Node.js installieren

Bei Thebrain registrieren und Schlüssel erstellen

Mit diesem Button Cursor öffnen

Schlüssel eintragen

KI-Chat in Cursor im Agent-Modus öffnen

Ausprobieren

Node.js installieren

Bei Thebrain registrieren und Schlüssel erstellen

Mit diesem Button VS Code öffnen

Schlüssel eintragen

KI-Chat in VS Code im Agent-Modus öffnen

Ausprobieren

Auf deinem Computer installiert

Werte, die du selbst einträgst

Auf einen Blick

Welche Apps ihn nutzen können

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Diskussion

Nutzerbewertungen

Im Vergleich mit anderen in Suche & KI-Gedächtnisi

Häufige Fragen

Alternativen

Ruflo

Context7

Metabase

README vom Entwickler

thebrain-mcp

Requirements

Install

Claude Code

Clients with a config file

Semantic search

Settings

Tools

brain_ingest

Skills

Deletion

Development

Documentation

Support

License

`brain_ingest`