threadmap-mcp

🗺️ Claude 向け ThreadMap MCP

Claude の会話の逸脱を可視化し、分岐できます。

元の意図を見失わないでください。会話がどこで逸脱したのかを正確に確認できます。どの時点からでも分岐し、整理されたコンテキストで再開できます。

---

実際の動作を見る

すべてのメッセージに色付きのドットを表示 — 逸脱をリアルタイムで追跡：

分岐ボタンを各転換点に備えたタイムラインパネル：

---

ThreadMap の 2 つの使い方

	MCP サーバー	Chrome 拡張機能
動作環境	Claude Code（ターミナル）	claude.ai（ブラウザー）
インストール	claude mcp add threadmap npx threadmap-mcp	chrome-extension/ フォルダーからパッケージ化されていない拡張機能を読み込む
利用できる機能	7 つのツール — 追跡、タイムライン、分岐、ブランチ	すべてのメッセージに色付きのドット、タイムラインパネル、ワンクリックで分岐
おすすめの用途	Claude Code で開発する開発者	claude.ai を日常的に使うすべての方

どちらもこのリポジトリに含まれています。片方でも両方でもご利用ください。

---

Chrome 拡張機能 — claude.ai に視覚的なドットを表示

Chrome 拡張機能は ThreadMap を claude.ai のインターフェースに直接挿入します。設定は不要です。インストールして Claude を開くだけです。

インストール（2 分）

1. Clone or download this repo
2. Open Chrome → chrome://extensions
3. Enable Developer mode (top right toggle)
4. Click Load unpacked → select the chrome-extension folder
5. Open any Claude conversation — ThreadMap activates automatically

表示される内容

• 色付きのドット：すべてのメッセージの横に表示され、元の意図からの逸脱率を示します
• 固定バー：上部に表示され、逸脱状況とメッセージ数をリアルタイムで示します
• ↺ 再スキャン — 過去の長い会話からすべてのメッセージを読み込みます
• タイムライン — 会話全体のマップを表示します。行をクリックすると、そのメッセージに移動します
• ⑂ 分岐 — 全コンテキストを入力欄にあらかじめ読み込んだ新しい Claude チャットを開きます

分岐の仕組み

1. タイムライン内、または任意のメッセージバブルの横にある ⑂ 分岐 をクリックします
2. 新しい claude.ai タブが自動的に開きます
3. 全コンテキスト（元の意図と、その時点までのすべてのメッセージ）が入力欄に貼り付けられます
4. 内容を確認して送信すると、整理された状態から Claude が会話を再開します

Chrome 拡張機能のファイル

chrome-extension/
├── manifest.json     — Extension config (Manifest v3)
├── content.js        — Core drift engine + DOM injection
├── threadmap.css     — All injected styles
├── popup.html        — Extension popup with color legend
├── icon16.png        — Icons
├── icon48.png
└── icon128.png

ご注意ください： この拡張機能はデベロッパーモード（パッケージ化されていない拡張機能を読み込む）を使用します。Chrome ウェブストア版は今後の予定に入っています。

---

MCP サーバー — Claude Code との連携

MCP サーバーは、プログラムから逸脱を追跡するための 7 つのツールを Claude Code に追加します。

インストール

claude mcp add threadmap npx threadmap-mcp

または、~/.claude/claude_desktop_config.json に手動で追加します：

{
  "mcpServers": {
    "threadmap": {
      "command": "npx",
      "args": ["threadmap-mcp"]
    }
  }
}

クイックスタート

threadmap_track(sessionId="myproject", role="user", content="build me a login system with JWT auth")
→ 🔵 Blue — Drift: 0% — Origin intent set

threadmap_track(sessionId="myproject", role="user", content="the refresh token keeps expiring after 30 seconds")
→ 🟠 Orange — Drift: 63% — ⚡ INFLECTION POINT detected

threadmap_timeline(sessionId="myproject")
→ Full color-coded map of all messages with fork instructions

threadmap_fork(sessionId="myproject", messageIndex=6, branchName="jwt-debug")
→ 🌿 Branch created — clean context from messages 1–7

7 つのツールすべて

ツール	機能
threadmap_track	メッセージを追跡し、逸脱スコアと色を取得します
threadmap_timeline	会話全体の色分けされたマップを表示します
threadmap_fork	任意のメッセージのインデックスから分岐します
threadmap_branch_context	任意のブランチ向けに整理されたコンテキストパケットを作成します
threadmap_status	現在の逸脱状況をすばやく確認します
threadmap_reset	スレッドをアーカイブし、新しく開始します
threadmap_legend	色の参照ガイドを表示します

---

カラーシステム

色	逸脱	意味
🔵 青	0–15%	予定どおり — 中心となる意図
🟢 緑	16–35%	有益な発展
🟡 黄	36–55%	関連する話題への逸脱
🟠 オレンジ	56–72%	転換点 — 意味のある方向転換
🔴 赤	73–88%	コンテキストが完全に分断
🟣 紫	89–95%	メタ — 会話についての会話
⚪ 白	96–100%	解決

オレンジと赤は分岐候補です。会話が元の意図から離れています。

---

実際の活用例

Claude Code — アーキテクチャの整合性 開発中はすべてのメッセージを追跡します。オレンジはスコープの拡大を示します。逸脱が悪化する前に分岐します。最初の 10 件のメッセージで決定したアーキテクチャを、整理された状態に保てます。

過去の長い会話 Chrome 拡張機能で ↺ 再スキャンをクリックします。ThreadMap は上部までスクロールし、すべてのメッセージを読み込んでスキャンした後、下部に戻ります。すべてのドットが表示されます。

チームへの引き継ぎ threadmap_branch_context を使って、決定事項を整理した要約を抽出します。新しいセッションに貼り付ければ、200 件のメッセージをスクロールして確認する必要はありません。

---

なぜオープンソースにするのか？

非線形な会話ナビゲーションは、AI ネイティブな作業に欠けている基本機能です。現在の Claude の会話は、目次も章もブックマークもない本のようなものです。

ThreadMap は目次です。これが標準になれば、Claude、GPT、Gemini など、あらゆるサービスで使えます。誰か一社が所有するものではなく、誰もが恩恵を受けます。

---

ロードマップ

• より豊かな意味的スコアリングを実現するローカル埋め込みモデル（MiniLM）
• Chrome ウェブストアでの Chrome 拡張機能の公開（デベロッパーモード不要）
• セッションをまたいだ永続化（SQLite モード）
• 視覚的なタイムラインのエクスポート（SVG/HTML）
• GPT / Gemini との互換性

---

コントリビューション

MIT ライセンスです。CONTRIBUTING.mdをご覧ください。

git clone https://github.com/Advertflair/threadmap-mcp
cd threadmap-mcp
npm install
npm run build

特に、ドリフトスコアリングの改善、Chrome 拡張機能の機能向上、その他の AI プラットフォームへの対応に関する PR を歓迎します。

---

ライセンス

MIT — LICENSEをご覧ください。

---

Advertflairが開発しました。オープンソースです。さあ、公開しましょう。