Agenten stärken
Der eigene Befehl des Herausgebers. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
npx -y @toportal/[email protected]Claude Code hat keinen Installationslink für einen lokalen Befehl. Kopieren Sie den Befehl unten und führen Sie ihn in einem Terminal aus.
BRAIN_VAULT=<value> BRAIN_MODO=<value> claude mcp add io.github.portaltocoding-second-brain-mcp -- npx -y @toportal/second-brain-mcp@0.1.1In einem Terminal ausführen.
{ "mcpServers": { "io.github.portaltocoding-second-brain-mcp": { "command": "npx", "args": [ "-y", "@toportal/[email protected]" ], "env": { "BRAIN_VAULT": "<value>", "BRAIN_MODO": "<value>" } } }}claude_desktop_config.json
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
Español · English
Tu segundo cerebro, en tu Obsidian, hablando con tu asistente.
Esto es un servidor MCP que convierte una carpeta de Markdown en un second brain de verdad: capturas lo que lees, lo conviertes en ideas con tus palabras, y esas ideas se conectan entre sí hasta formar un grafo que : cuando trabajas en algo, las notas relacionadas aparecen solas.
Second brain en Obsidian: notas, conceptos como nodos, resurfacing y salud del grafo. En castellano.
Todo en castellano. Todo en ficheros tuyos. Sin bases de datos, sin nube, sin magia que no puedas abrir con un editor de texto.
Le dices a tu asistente:
«Estoy leyendo Hábitos Atómicos, apunta esto: el entorno decide más que la fuerza de voluntad»
y él crea la lectura si no existía, guarda el apunte, y cuando esa idea madure la
convierte en una nota permanente conectada al concepto [[Hábitos]], que a su
vez acumula todo lo que has pensado sobre el tema, venga del libro que venga.
Semanas después, trabajando en otra cosa, preguntas por diseñar tu rutina de mañanas y el sistema te trae de vuelta «El entorno decide por ti» con el párrafo exacto. Eso es el segundo cerebro: no recordar tú, que recuerde él.
Cada etiqueta es método / qué es; en las dos puertas principales va también la
frase que lo dispara:
tú + tu asistente
│ ▲
ingerir / ingesta │ │ resurgir / recuerdo
«añade esto» ▼ │ «¿qué sé de esto?»
┌──────────────┐
│ second-brain │
└───────┬──────┘
clasifica lo que entra
┌───────────────────────────┼───────────────────────────┐
│ lectura_crear / ficha │ nota_permanente / idea │ mini_nota / apunte
│ lectura_nota / apuntes │ │
▼ ▼ ▼
┌──────────────┐ ┌─────────────┐ ┌────────────────┐
│ 40-Lecturas/ │ │ 50-Notas/ │ │ proyecto/brain/│
│ lo que entra │ │ lo que queda│ │ el taller │
└──────┬───────┘ └──────┬──────┘ └────────┬───────┘
│ │ │
│ nota_permanente / │ temas │ mini_promover /
│ la idea madura │ │ madura o resuena
└──────────────────────────▶│───────────┐ │
│ ▼ │
nota_enlazar / │ ┌───────────────┐ │
relacionar con │ │ 60-Conceptos/ │◀──────┘
motivo (2-3 máx) ▼ │ lo que conecta│
otras ideas└───────────────┘
jardin / poda «¿cómo está el jardín?» · concepto_fusionar / coser nodos
vault_buscar / grep «busca dónde dije X» · mini_listar / cosecha del taller
Si usas Claude Code:
claude mcp add --scope user second-brain -- npx -y @toportal/second-brain-mcp
Con cualquier otro cliente MCP:
{
"mcpServers": {
"second-brain": {
"command": "npx",
"args": ["-y", "@toportal/second-brain-mcp"]
}
}
}
Sin variables de entorno y sin decidir nada: tu cerebro se monta en
~/second-brain, con las tres carpetas y la portada listas. Dile a tu asistente
«hazme el onboarding de mi second brain» y ya estás dentro.
¿Prefieres que viva en tu vault de Obsidian de siempre? Añade
BRAIN_VAULT=/ruta/a/tu/vault y punto — el servidor solo escribe en tres
subcarpetas y no toca nada más. Y si ya empezaste en el vault por defecto,
mueve la carpeta a donde quieras y apunta BRAIN_VAULT allí: son ficheros
Markdown, no hay nada que migrar.
Si usas Claude Desktop y no quieres saber nada de comandos ni de JSON,
descarga
second-brain.mcpb
y haz doble clic: Claude Desktop lo abre, te pide elegir la carpeta donde
vivirá tu cerebro (tu vault de Obsidian si tienes, o una carpeta vacía
cualquiera) y ya está. No necesitas instalar Node ni tocar ningún fichero de
configuración. Y si además quieres ver tu cerebro dibujado como un grafo,
instala Obsidian y abre esa misma carpeta como vault.
Necesitas Node 18 o más nuevo. Con Claude Code, a nivel de usuario (disponible en todos tus proyectos):
claude mcp add --scope user second-brain \
--env BRAIN_VAULT=/ruta/a/tu/vault \
-- npx -y @toportal/second-brain-mcp
Con cualquier otro cliente MCP:
{
"mcpServers": {
"second-brain": {
"command": "npx",
"args": ["-y", "@toportal/second-brain-mcp"],
"env": { "BRAIN_VAULT": "/ruta/a/tu/vault" }
}
}
}
Y listo. La primera nota crea las carpetas que hagan falta.
Una salvaguarda: si la ruta que configuras no existe y su carpeta contenedora tampoco, el servidor da por hecho que es un error al escribirla y te lo dice en la conversación en vez de plantarte un vault en una carpeta fantasma. Si el padre existe, la crea sin preguntar: eso es lo que querías.
Si prefieres dejar el vault montado desde el principio (carpetas + portada), hay andamiaje:
npx -y @toportal/second-brain-mcp --init /ruta/a/tu/vault
Es idempotente: sobre un vault que ya existe no toca nada.
No te la tienes que inventar: dile a tu asistente «hazme el onboarding de mi
second brain» (es el prompt empezar; en Claude Code aparece como el comando
/mcp__second-brain__empezar) y él te guía paso a paso: mira cómo está tu
vault, planta contigo la primera lectura y la primera idea con tus propias
palabras, te enseña qué devuelve resurgir con tu material, y te deja la
chuleta de los tres gestos del día a día. Si el vault ya tiene contenido no te
trata de nuevo: te hace un tour de lo que hay.
El repo trae un vault de ejemplo ya tejido en ejemplo/, con dos lecturas,
cuatro ideas y cuatro conceptos conectados entre sí, así que puedes ver el
grafo funcionando antes de haber escrito una sola nota tuya:
git clone https://github.com/Portaltocoding/second-brain-mcp
cd second-brain-mcp && npm install
claude mcp add second-brain --env BRAIN_VAULT=$PWD/ejemplo -- node src/server.js
Y le preguntas a tu asistente algo como «¿qué sé yo sobre la fuerza de
voluntad?». También puedes abrir la carpeta ejemplo/ como vault en Obsidian
y ver el grafo dibujado.
Así se ve el día a día, sin aprenderse ninguna tool:
Tú: añade esto a mi second brain, lo más importante: "llevo semanas notando que si dejo el móvil en otra habitación por la mañana me salen dos horas de trabajo del tirón, y si lo tengo al lado voy a rachas de diez minutos entre miradas"
Asistente: esto es un pensamiento tuyo ya digerido, así que va como nota permanente en modo destilar. La idea fuerte que veo: «La distancia física al móvil marca la profundidad del trabajo», con los conceptos
FocoyEntorno, que ya existen en tu grafo. ¿La creo así?Tú: dale
Asistente: creada. Y resuena fuerte con «El foco se diseña, no se invoca» (score 8): las dos hablan de preparar el entorno en vez de confiar en la voluntad. ¿Las enlazo con ese motivo?
Tú: sí
Asistente: enlazadas, motivo escrito en las dos. Te dejo el enlace para abrirla en Obsidian:
obsidian://open?path=...
Fíjate en el orden: el asistente propone, tú decides, y cada conexión queda con su porqué escrito. Eso es todo el sistema.
tu-vault/
├── 40-Lecturas/ lo que entra: libros, artículos, vídeos, cursos
├── 50-Notas/ lo que queda: ideas permanentes, tuyas, con tu título
└── 60-Conceptos/ lo que conecta: cada tema es una nota real con backlinks
La regla de oro: nada entra suelto. Cada idea se enlaza a su origen, a los conceptos que toca y, con moderación, a otras ideas. Y la moderación importa: máximo 2-3 notas relacionadas, cada enlace con su porqué escrito. Un cajón con doce enlaces no conecta nada; tres enlaces con motivo son un mapa.
Capturar. lectura_crear abre la ficha de un libro o artículo;
lectura_nota guarda apuntes mientras lees («cap 3: ...»); cuando una idea es
tuya de verdad, nota_permanente la sube a 50-Notas/ con sus temas convertidos
en conceptos navegables. nota_enlazar une dos ideas y deja escrito por qué.
Pensar. resurgir es el corazón: le das un texto (una tarea, una duda, una
idea a medias) y te devuelve las notas más conectadas con él. Solo aparece cuando
hay solape real; si no hay nada, no inventa. vault_buscar es el grep de toda la
vida, acotado para no inundar (20 resultados y te avisa si hubo más).
Podar. Los grafos se pudren en silencio. jardin te enseña las notas
huérfanas, los enlaces rotos, los conceptos que nadie definió, las notas
sobreconectadas y los conceptos duplicados («Hábito» y «Habitos» partiendo los
backlinks en dos). concepto_fusionar cose los nodos partidos.
Taller por proyecto. Cualquier repo puede tener su brain/ local con
apuntes crudos (mini_nota). mini_listar te dice cuáles se han ganado subir a
la biblioteca (resuenan fuerte con lo que ya tienes, o llevan una semana
madurando) y mini_promover los sube. Taller abajo, biblioteca arriba: y
promover siempre es decisión tuya.
No hace falta que te aprendas las tools. Dile a tu asistente:
«añade esto directo a mi second brain» «añade lo más importante de esto» «apunta esto que estoy escribiendo»
y la ingesta se dispara según toque. El servidor trae el procedimiento escrito
(prompt MCP ingerir; en Claude Code aparece como comando
/mcp__second-brain__ingerir): clasifica el texto (¿lectura con fuente, idea
tuya, apunte de taller?), aplica el modo (directo guarda íntegro, destilar
extrae las 1-3 ideas fuertes en tus palabras y te las enseña antes de crear
nada, auto decide y te lo dice), identifica 2-4 conceptos (prefiriendo los
que ya existen en tu grafo antes que inventar sinónimos), y teje. Las decisiones
son tuyas y están marcadas como tales: qué ideas entran y qué conexiones se
crean. Vale para un párrafo pegado, un capítulo, o ese documento de Word que
estás escribiendo: pégalo o pásale el fichero.
Cada nota del grafo es también un resource MCP, así que leerla entera no
gasta una tool call (y en Claude Code puedes adjuntarla con @):
vault://lectura/{titulo}
vault://nota/{titulo}
vault://concepto/{nombre}
El patrón que funciona: buscar barato (vault_buscar, resurgir), leer entero
solo lo que interesa (el resource).
Funciona igual, porque esto es MCP estándar y el protocolo ya lo habla casi todo el mundo. La escalera completa, de más cómodo a más independiente:
.mcpb. La única sin tocar
nada.Es su casa. Todo es Markdown plano con wikilinks nativos: graph view, backlinks
y hover preview funcionan sin plugins. El servidor relee siempre (nunca cachea)
y escribe de forma atómica, así que puedes editar en Obsidian con el servidor
corriendo sin que se pisen. El jardin juzga los enlaces como Obsidian: sin
distinguir mayúsculas.
Dos detalles útiles:
ruta en disco —que sirve siempre— y un enlace
abrir (obsidian://open?path=...): un clic y estás en la nota dentro de la
app, si la tienes. Va por ruta absoluta, así que da igual cómo hayas llamado a
tu vault o que apuntes a una subcarpeta suya.temas y relacionadas viven en las propiedades (frontmatter). Obsidian los
trata como enlaces reales, pero para verlos en el graph view activa
«Propiedades» en los ajustes del grafo.¿Y Notion? No. Este servidor trabaja sobre ficheros Markdown locales. Esa es la gracia: tus datos son tuyos, se abren con cualquier editor y el grafo va a la velocidad del disco, no de una API. Obsidian tampoco es obligatorio (vale cualquier carpeta
.md); es solo el mejor visor. Si vienes de Notion: exporta tus notas como Markdown y suéltalas en el vault, y eso sí funciona.
resurgir tiene dos motores, y el sistema te dice cuándo cambiar:
lexico (por defecto): puntúa coincidencias donde más significan:
título ×3, temas ×2, cuerpo ×1. Directo y transparente; con un brain pequeño
o mediano es todo lo que necesitas.rag: BM25 por fragmentos con stemming castellano: «hábito» encuentra
«hábitos», y en vez de decirte solo qué nota conecta, te devuelve el
párrafo exacto que responde, listo para usar como contexto. Pensado para
cuando el brain crece y las notas son largas.¿Cuál usar? No lo pienses: empieza en lexico y deja que el sistema te guíe.
La sugerencia de pasar a rag aparece solo cuando toca, cuando se dan las
dos cosas a la vez:
BRAIN_RAG_UMBRAL), yY una sola vez por sesión: te lo dice, te explica el porqué, y no vuelve a
insistir. Si el léxico encuentra fuerte, no te interrumpe nadie. Probar es
gratis: repite la consulta con modo: "rag" y compara; si convence, se fija
con BRAIN_MODO=rag. Sin índices que reconstruir ni modelos que descargar:
los dos motores releen el vault al vuelo, así que puedes seguir editando en
Obsidian sin miedo.
readOnlyHint)
y la única destructiva (concepto_fusionar) también, para que tu cliente pida
confirmación donde toca.npm install
npm test
MIT. Úsalo, cámbialo, hazlo tuyo.
Second brain en Obsidian: notas, conceptos como nodos, resurfacing y salud del grafo. En castellano.
{ "mcpServers": { "io.github.portaltocoding-second-brain-mcp": { "command": "npx", "args": [ "-y", "@toportal/[email protected]" ], "env": { "BRAIN_VAULT": "<value>", "BRAIN_MODO": "<value>" } } }}Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
Der Herausgeber nennt diese Umgebungsvariablen: BRAIN_VAULT, BRAIN_MODO.
Second Brain läuft lokal über stdio.
Zuletzt geprüft: 2026-11-09. Second brain en Obsidian: notas, conceptos como nodos, resurfacing y salud del grafo. En castellano.