second-brain-mcp

second-brain-mcp

スペイン語 · 英語

Obsidian にある、アシスタントと会話するあなたのセカンドブレインです。

これは、Markdown フォルダーを本物のセカンドブレインに変える MCP サーバーです。読んだ内容を記録し、自分の言葉でアイデアに変え、そのアイデア同士をつないで、一緒に考えてくれるグラフを作ります。何かに取り組むと、関連するノートが自動的に表示されます。

すべてスペイン語です。すべてあなたのファイルです。データベースもクラウドも、テキストエディターで開けないような魔法もありません。

どんな使い心地ですか？

アシスタントにこう伝えます。

「『Atomic Habits』を読んでいるんだけど、これをメモして：環境は意志の力よりも大きく左右する」

すると、まだなければ読書ノートを作成し、メモを保存します。そのアイデアが深まると、[[Habits]] という概念につながる永続的なノートに変換されます。このノートには、そのテーマについて考えたことが、どの本から得たものでも蓄積されていきます。

数週間後、別のことに取り組んでいるとき、朝のルーティンの設計について尋ねると、システムは*「環境があなたに代わって決める」*という言葉を、該当する段落とともに呼び戻してくれます。それがセカンドブレインです。あなたが覚えるのではなく、アシスタントに覚えてもらうのです。

マップ

各ラベルは 方法 / 内容 を表します。主要な 2 つの入口には、それを呼び出すフレーズも記載しています。

                             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

インストール

最速の方法：1 行だけ、設定不要

Claude Code を使っている場合：

claude mcp add --scope user second-brain -- npx -y @toportal/second-brain-mcp

ほかの MCP クライアントの場合：

{
  "mcpServers": {
    "second-brain": {
      "command": "npx",
      "args": ["-y", "@toportal/second-brain-mcp"]
    }
  }
}

環境変数の設定も、選択も不要です。脳は ~/second-brain に、3 つのフォルダーとトップページが用意された状態で作成されます。アシスタントに「セカンドブレインのオンボーディングをして」と伝えれば、すぐに始められます。

いつもの Obsidian の vault に置きたいですか？BRAIN_VAULT=/ruta/a/tu/vault を追加するだけです。サーバーは 3 つのサブフォルダーにのみ書き込み、それ以外には触れません。すでにデフォルトの vault で始めている場合は、フォルダーを好きな場所に移動し、BRAIN_VAULT をその場所に設定してください。Markdown ファイルなので、移行は不要です。

ターミナル不要：ダブルクリックするだけ

Claude Desktop を使っていて、コマンドや JSON のことを気にしたくない場合は、 second-brain.mcpb をダウンロードしてダブルクリックしてください。Claude Desktop が開き、脳を置くフォルダー（Obsidian を使っている場合はその vault、または任意の空フォルダー）を選ぶよう求められます。これで完了です。Node のインストールも、設定ファイルの編集も必要ありません。さらに、脳をグラフとして表示したい場合は、Obsidianをインストールし、同じフォルダーを vault として開いてください。

ターミナルを使って、フォルダーを自分で選ぶ

Node 18 以降が必要です。Claude Code を使う場合、ユーザーレベル（すべてのプロジェクトで利用可能）で設定します。

claude mcp add --scope user second-brain \
  --env BRAIN_VAULT=/ruta/a/tu/vault \
  -- npx -y @toportal/second-brain-mcp

ほかの MCP クライアントの場合：

{
  "mcpServers": {
    "second-brain": {
      "command": "npx",
      "args": ["-y", "@toportal/second-brain-mcp"],
      "env": { "BRAIN_VAULT": "/ruta/a/tu/vault" }
    }
  }
}

これで完了です。最初のノートを作成すると、必要なフォルダーが作られます。

安全策として、設定したパスが存在せず、その親フォルダーも存在しない場合、サーバーはパスの入力ミスと判断して、存在しないフォルダーに vault を作成するのではなく、会話内でその旨を知らせます。親フォルダーが存在する場合は、確認なしで作成します。それが意図した動作だからです。

最初から vault をセットアップしておきたい場合（フォルダーとトップページを作成）、初期構成を生成できます。

npx -y @toportal/second-brain-mcp --init /ruta/a/tu/vault

冪等性があるため、すでに存在する vault には何も変更を加えません。

環境変数

変数	説明	デフォルト
BRAIN_VAULT	vault のパス（最初の引数としても指定できます）。指定しない場合は、デフォルトの vault が使われます	~/second-brain
BRAIN_MODO	resurgir のエンジン：lexico または rag	lexico
BRAIN_RAG_UMBRAL	rag モードを提案できるようになるノート数	50

はじめてのセッション

考え込む必要はありません。アシスタントに「second brain のオンボーディングをして」と伝えてください（プロンプトは empezar です。Claude Code ではコマンド /mcp__second-brain__empezar として表示されます）。すると、手順に沿って案内してくれます。vault の状態を確認しながら、最初の読書メモと自分の言葉で書いた最初のアイデアを一緒に作成し、あなたの資料を使って resurgir が何を返すのかを見せてくれます。そして、日々使う3つの操作をまとめたチートシートも用意してくれます。vault にすでにコンテンツがある場合は、初めての人向けではなく、既存の内容を案内してくれます。

30秒で試す

リポジトリには、ejemplo/ にすでに作成済みのサンプル vault が付属しています。2つの読書メモ、4つのアイデア、互いにつながった4つの概念があるので、自分のメモを一つも書く前に、グラフが動く様子を確認できます。

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

そして、アシスタントに「意志力について、私は何を知っている？」といった質問をしてみてください。ejemplo/ フォルダーを Obsidian で vault として開き、描画されたグラフを見ることもできます。

実際のセッション

日々の使い方は次のとおりです。ツールを覚える必要はありません。

あなた： これを自分の second brain に追加して。最も重要な点はこれです。"何週間も気づいているのですが、朝、携帯電話を別の部屋に置いておくと、2時間ぶっ続けで仕事ができます。手元に置いておくと、10分ごとに確認して作業が途切れます"

アシスタント： これはすでに咀嚼されたあなた自身の考えなので、蒸留モードで恒久メモとして追加します。重要なアイデアは、**「携帯電話との物理的な距離が、仕事への集中の深さを決める」**だと思います。グラフにすでにある概念 Foco と Entorno に関連づけます。この内容で作成しますか？

あなた： どうぞ

アシスタント： 作成しました。そして、「集中力は呼び起こすのではなく、設計するもの」（スコア8）と強く響き合っています。どちらも意志力に頼るのではなく、環境を整えることについて述べています。この理由を添えて、2つをリンクしますか？

あなた： はい

アシスタント： リンクしました。理由は両方に記載してあります。Obsidian で開くためのリンクはこちらです：obsidian://open?path=...

順番に注目してください。アシスタントが提案し、あなたが決めます。そして、それぞれのつながりには理由が書き添えられます。システム全体はこれだけです。

3つのフォルダー

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

黄金律は、何も単独では入れないことです。すべてのアイデアを、その出典、関連する概念、そして控えめな数のほかのアイデアにリンクします。控えめにすることが大切です。関連メモは最大2〜3件とし、リンクにはそれぞれ理由を書き添えます。12個のリンクがあるだけの引き出しでは何もつながりません。理由のある3つのリンクが、地図になります。

できること

取り込む。 lectura_crear は本や記事の記録を作成します。lectura_nota は読書中のメモ（「第3章：...」など）を保存します。アイデアが本当に自分のものになったら、nota_permanente がテーマをナビゲーション可能な概念に変換して 50-Notas/ に追加します。nota_enlazar は2つのアイデアを結びつけ、その理由を書き残します。

考える。 resurgir は中核となる機能です。テキスト（タスク、疑問、まとまりきっていないアイデアなど）を渡すと、それと最もつながりの深いメモを返します。実際に重なりがある場合だけ表示し、何もなければ作り上げません。vault_buscar はおなじみの grep で、結果があふれないよう20件に制限され、それ以上ある場合は通知します。

整理する。 グラフはいつの間にか荒れていきます。jardin は、孤立したメモ、壊れたリンク、誰も定義していない概念、リンクが多すぎるメモ、重複した概念（「Hábito」と「Habitos」のようにバックリンクが二分されているもの）を表示します。concepto_fusionar は分裂したノードを統合します。

プロジェクトごとの作業場。 どのリポジトリにも、未整理のメモ（mini_nota）を保存する独自のローカル brain/ を用意できます。mini_listar は、ライブラリに追加する価値があるメモ（すでにある内容と強く響き合うものや、1週間かけて熟成したもの）を教えてくれます。mini_promover はそのメモをライブラリに移します。作業場は下、ライブラリは上。そして、昇格させるかどうかは常にあなたが決めます。

インジェスト：ひとつの操作

ツールを覚える必要はありません。アシスタントにこう伝えてください。

「これをそのままsecond brainに追加して」 「これのいちばん重要なところを追加して」 「いま書いているこれをメモして」

内容に応じてインジェストが実行されます。サーバーには手順が記述されています （MCP プロンプト ingerir。Claude Code ではコマンド /mcp__second-brain__ingerir として表示されます）：テキストを分類し（出典付きの読書内容か、自分のアイデアか、ワークショップのメモか）、モードを適用し（directo は全文を保存し、destilar は重要なアイデアを1〜3個 自分の言葉で 抜き出し、何も作成する前に表示します。auto は判断して、その内容を伝えます）、2〜4個の概念を特定し（同義語を新たに作るより、既存のグラフにあるものを優先します）、つなぎ合わせます。判断するのはあなたです。どのアイデアを取り込むか、どのつながりを作るかは、あなたが決めたものとして示されます。貼り付けた段落、章、執筆中のWord文書にも使えます。貼り付けるか、ファイルを渡してください。

ノートを読む：リソース

グラフ内の各ノートはMCP リソースでもあるため、全文を読んでもツール呼び出しを消費しません（Claude Code では @ を使って添付できます）。

vault://lectura/{titulo}
vault://nota/{titulo}
vault://concepto/{nombre}

うまくいくパターンは、まず手軽に検索し（vault_buscar、resurgir）、必要なものだけ全文を読むことです（リソース）。

Claudeを使っていない場合は？

MCP 標準に準拠しており、このプロトコルはすでに多くのクライアントで利用できるため、同じように使えます。手軽なものから、より独立性の高いものまで、ひと通り紹介します。

1. Claude Desktop：.mcpb をダブルクリックする方法です。何も設定する必要がない唯一の方法です。
2. その他のMCPクライアント（デスクトップ版ChatGPT、Cursor、VS Code、Windsurf、Zed、Gemini CLIなど）：上記のJSON設定ブロックを使います。どのクライアントでも同じです。
3. アカウント不要、インターネット不要：LM StudioはローカルモデルでのMCPに対応しているため、second brainを自分のコンピューター上で動くモデルに接続できます。ノートがディスクの外に出ることはありません。
4. AIを一切使わない：vaultは通常のMarkdownファイルとwikilinkでできています。Obsidianだけでも、手動で使えるsecond brainとして十分です。サーバーはアイデアを記録し、要約して、再び提示する副操縦士ですが、ノートが誰かの人質になることはありません。

Obsidianとの連携

Obsidianが本来の場所です。すべてがネイティブのwikilinkを含むプレーンなMarkdownなので、グラフビュー、バックリンク、ホバープレビューがプラグインなしで機能します。サーバーは常に読み込み直し（キャッシュはしません）、アトミックに書き込むため、サーバーを起動したままObsidianで編集しても、互いの変更が上書きされることはありません。jardin はObsidianと同じようにリンクを判定し、大文字と小文字を区別しません。

便利な点が2つあります。

• 作成された各ノートには、常に使えるディスク上の ruta と、abrir リンク（obsidian://open?path=...）が返されます。クリックすると、アプリがインストールされていれば、そのノートがアプリ内で開きます。絶対パスを使うため、vaultの名前や、vault内のサブフォルダーを指定したかどうかに左右されません。
• temas と relacionadas はプロパティ（frontmatter）に保存されます。Obsidianはこれらを実際のリンクとして扱いますが、グラフビューに表示するには、グラフの設定で「プロパティ」を有効にしてください。

Notionは使えますか？ いいえ。このサーバーはローカルのMarkdownファイルを扱います。そこが利点です。データは自分のもので、どのエディターでも開けます。グラフの速度もAPIではなくディスク次第です。Obsidianも必須ではなく、.md ファイルを保存できるフォルダーなら何でも使えます。Obsidianは最適なビューアーというだけです。Notionから移行する場合は、ノートをMarkdownとしてエクスポートしてvaultに入れてください。それなら問題なく使えます。

語彙モードと rag モード

resurgirには2つのエンジンがあり、切り替えどきはシステムが教えてくれます。

• lexico（デフォルト）：重要度に応じて一致をスコアリングします。 タイトル×3、トピック×2、本文×1。直接的で透明性が高く、小規模または 中規模のbrainならこれだけで十分です。
• rag：スペイン語のステミングに対応した、チャンク単位のBM25です。「hábito」で 「hábitos」が見つかり、つながりのあるメモが何かだけでなく、答えとなる 正確な段落が返されるため、そのままコンテキストとして使えます。brainが 大きくなり、メモが長くなったときに向いています。

どちらを使えばよいでしょうか？考え込まず、まずはlexicoから始めて、システムの案内に従ってください。 ragへの切り替えの提案は、必要なときに限って表示されます。次の2つの条件が 同時に満たされた場合です。

1. brainにメモがかなり増えていること（50件以上。BRAIN_RAG_UMBRALで 変更できます）。かつ
2. 直前の検索が語彙検索でうまくいかなかったこと（結果がない、または 強いつながりの基準に届かなかった）。つまり、ragが役立つタイミングです。

提案はセッションごとに一度だけです。理由とともに知らせたあとは、繰り返しません。 語彙検索で強い結果が見つかれば、邪魔することもありません。試すのは無料です。 modo: "rag"で同じ検索を繰り返して比べ、よければBRAIN_MODO=ragで固定できます。 再構築が必要なインデックスも、ダウンロードが必要なモデルもありません。 どちらのエンジンもvaultをその都度読み込むため、安心してObsidianで編集を続けられます。

原則（なぜこうなっているのか気になった方へ）

• 少ないことに意味があります。 つながりの提案は、強い場合に限って表示されます （最大2件）。何もかもをつなげるのは、何もつながないのと同じです。
• つなげるかどうかはあなたが決めます。 システムが提案し、決めるのはあなたです。 副作用としてつながりが作成されることはありません。
• vaultが優先されます。 サーバーは常に読み直し、キャッシュしません。手作業で編集しても、 Obsidianを使っても、好きな方法で同期しても構いません。書き込みはアトミックに行われ、 frontmatterは1行ずつ編集されるため、フォーマットには手を加えません。
• コンテキストにはコストがかかります。 JSON形式のコンパクトな応答、範囲を絞った検索、 上限を設けた診断を採用しています。読み取り専用のツールにはreadOnlyHintが設定され、 唯一の破壊的なツール（concepto_fusionar）にも同様に設定されているため、 必要な場面でクライアントが確認を求められます。

開発

npm install
npm test

ライセンス

MIT。自由に使い、変更し、自分のものにしてください。