MAXential-Thinking-MCP

MAXential Thinking MCP

AI 向けの構造化された永続的な推論ワークスペースです。思考の連鎖の構築、分岐による別の選択肢の検討、以前の思考の修正、推論履歴の検索、コンテキストウィンドウのリセットやサーバーの再起動をまたいだセッションの保存を行うための 20 個のツールを提供します。

AI に組み込まれた推論は一時的なものです。コンテキストウィンドウがいっぱいになると、思考は圧縮されるか失われます。複雑な問題に取り組むには、複数のアプローチを検討し、行き詰まった場合に元に戻り、中断したところから再開できる必要があります。MAXential は推論をワークスペースとして外部化し、永続化、分岐、継続を可能にします。

起源

Anthropic の sequential-thinking MCP サーバーからフォークしました。このサーバーは 9 個のパラメーターを持つ単一のツールを提供していました。スキーマには分岐用のパラメーター（branch_from_thought、branch_id）が含まれていましたが、分岐の作成、切り替え、管理を行うツールがなかったため、これらのパラメーターは実質的に機能していませんでした。

MAXential はこの単一のツールを完全に置き換え、3 回のリリースにわたって、目的別のツールを 20 個構築しました。

Version	What was built
v2.0	単一のツールを、11 個の用途に特化したツールに置き換えました。コアとなる思考（think、revise、complete）、完全な分岐管理（branch、switch_branch、list_branches、get_branch、close_branch、merge_branch）、ナビゲーション（get_thought、get_history）です。
v2.2	5 個の整理用ツールを追加しました。tag、search、export、visualize、reset です。
v2.3	SQLite ストレージを使用する、セッション永続化用ツールを 4 個追加しました。session_save、session_load、session_list、session_summary です。

ツール

コアとなる思考

Tool	What it does
think	推論の連鎖に思考を追加します。思考には番号が付けられ、自動的に永続化されます。
revise	以前の思考に誤りや不備があった場合、その思考を修正します。元の思考は修正履歴とともに保持されます。
complete	最終的な結論をもって、思考の連鎖を完了としてマークします。
reset	現在のセッションを消去し、新しく開始します。

分岐

Tool	What it does
branch	メインの流れを失わずに別の道筋を検討できるよう、新しい推論の分岐を作成します。
switch_branch	別の分岐、またはメインにコンテキストを切り替えます。
list_branches	すべての分岐を、ステータスと各分岐の思考数とともに一覧表示します。
get_branch	特定の分岐の詳細をすべて取得します。
close_branch	任意で結論を添えて、分岐を終了します。
merge_branch	分岐からの知見をメインに統合します。戦略：conclusion_only、full_integration、summary。

ナビゲーション

Tool	What it does
get_thought	番号を指定して、特定の思考を取得します。
get_history	分岐による絞り込みに対応した、思考履歴を取得します。

整理

Tool	What it does
tag	思考に意味的なタグ（例：仮説、証拠、決定、発見）を追加または削除します。
search	内容のテキストまたはタグで思考を検索します。
export	思考の連鎖を Markdown または JSON としてエクスポートします。
visualize	思考の構造と分岐を ASCII または Mermaid の図として生成します。

セッションの永続化

Tool	What it does
session_save	後で取得できるよう、現在のセッションに名前と説明を付けます。
session_load	保存済みのセッションを復元します。すべての思考、分岐、タグがメモリに読み込まれます。
session_list	利用可能なセッションを、最終更新日時の新しい順に表示します。
session_summary	トークン効率のよいコンテキスト読み込みのために、セッションの圧縮された要約を生成します。

作業中のセッションは SQLite に自動的に永続化されます。think、branch、tag、revise を呼び出すたびに、リアルタイムでディスクに書き込まれます。セッションはサーバーの再起動、コンテキストウィンドウのリセット、新しい会話をまたいで保持されるため、中断したところから再開できます。

元の実装が提供する機能と、MAXential が提供する機能

機能	Anthropic sequential-thinking	MAXential Thinking
インターフェース	1 つのツール、9 個のパラメーター	20 個の特化したツール
分岐	スキーマにパラメーターがあるが、実装はなし	作成、切り替え、一覧表示、確認、マージ、終了までの完全なライフサイクル
修正	非対応	任意の思考を修正可能。元の内容は履歴とともに保持
永続化	なし — サーバーの再起動時に消失	SQLite — 再起動、コンテキストのリセット、新しい会話の後も保持
タグ付け	非対応	任意の思考に意味的なタグを付与
検索	非対応	内容またはタグで検索
エクスポート	非対応	Markdown、JSON、Mermaid 図、ASCII ビジュアライゼーション
ナビゲーション	非対応	番号を指定して任意の思考を取得、フィルター済み履歴を閲覧

セッション履歴の閲覧

セッションデータは、標準の SQLite データベースである .maxential/thinking.db に保存されます。過去の思考セッションを閲覧する方法はいくつかあります。

ツール自体を使う — AI に session_list を使ってセッションを閲覧するよう依頼したり、session_load でセッションを復元したり、session_summary で要約を取得したりできます。AI は会話形式でセッション内容を整形、検索、要約できます。

SQLite ブラウザーを使う — .maxential/thinking.db を任意の SQLite ビューアー（VS Code/VSCodium の拡張機能、DB Browser for SQLite など）で開きます。スキーマはシンプルです。

テーブル	内容
sessions	セッション ID、名前、説明、ステータス、タイムスタンプ
thoughts	思考の番号、内容、分岐、修正リンクを含むすべての思考
branches	分岐のメタデータ、ステータス、結論、マージ履歴
tags	思考に付与された意味的なタグ

ターミナルから：

sqlite3 .maxential/thinking.db "SELECT name, status, datetime(created_at/1000, 'unixepoch', 'localtime') as created FROM sessions ORDER BY updated_at DESC LIMIT 10;"

インストール

Claude Desktop / Claude Code

MCP の設定に追加します。

Claude Desktop の設定ファイルの場所：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "maxential-thinking": {
      "command": "npx",
      "args": ["-y", "@bam-devcrew/maxential-thinking-mcp"]
    }
  }
}

ソースから

git clone https://github.com/BAM-DevCrew/MAXential-Thinking-MCP.git
cd MAXential-Thinking-MCP
npm install
npm run build

次に、以下のように設定します。

{
  "mcpServers": {
    "maxential-thinking": {
      "command": "node",
      "args": ["/path/to/MAXential-Thinking-MCP/dist/src/index.js"]
    }
  }
}

設定

永続化

セッションデータは SQLite に保存されます。デフォルトでは、データベースは作業ディレクトリ内の .maxential/thinking.db に作成されます。

{
  "mcpServers": {
    "maxential-thinking": {
      "command": "npx",
      "args": ["-y", "@bam-devcrew/maxential-thinking-mcp"],
      "env": {
        "MAXENTIAL_DB_PATH": "/path/to/your/thinking.db"
      }
    }
  }
}

MAXENTIAL_DB_PATH の値	動作
(未設定)	作業ディレクトリ内の .maxential/thinking.db
/path/to/file.db	明示的に指定したファイルパスを使用
:memory:	インメモリのみ — 再起動後は永続化されません

SQLite の初期化に失敗した場合（権限やネイティブモジュールの問題など）、サーバーは自動的にインメモリモードに切り替わり、クラッシュすることはありません。

セッションデータをバージョン管理の対象外にするには、プロジェクトの .gitignore に .maxential/ を追加してください。

ロギング

{
  "mcpServers": {
    "maxential-thinking": {
      "command": "npx",
      "args": ["-y", "@bam-devcrew/maxential-thinking-mcp"],
      "env": {
        "MAXENTIAL_LOG_FILE": "/path/to/error.log"
      }
    }
  }
}

使用方法

これらのツールを直接呼び出すのではなく、AI に MAXential thinking を使うよう依頼すると、AI が推論の一環としてツールを呼び出します。実際の使い方を以下に示します。

意思決定を進める：

この件について maxential thinking を使ってください。新しい API には REST と GraphQL のどちらを採用すべきですか？

AI は質問を分析する思考の連鎖を構築し、それぞれのアプローチを個別に検討するための分岐を作成し、トレードオフを含む思考を追加して、調査結果を統合し、結論に至ります。推論の全過程が番号付きで構造化され、保存されます。

複数のアプローチを検討する：

maxential を使って認証の再設計を検討してください。JWT、セッショントークン、OAuth の分岐を見たいです。

AI は3つの分岐を作成し、それぞれのアプローチを個別に検討してから、知見を統合して比較します。分岐を切り替えたり、行き詰まった分岐を閉じたり、特定の経路をさらに深掘りしたりするよう依頼できます。

以前の思考を再開する：

データベースの最適化オプションを分析したセッションを読み込んでください。

AI は保存済みのセッションを参照して該当するものを見つけ、すべての思考、分岐、タグをそのまま復元し、別の会話にまたがっていても、中断したところから推論を続けます。

過去の推論を確認する：

maxential thinking の履歴から、decision とタグ付けされたものを検索してください。

AI はセッション内のタグ付き思考を検索して、結果を返します。思考の連鎖全体を markdown としてエクスポートしたり、思考構造の図を生成したりするよう依頼することもできます。

簡単な要約を得る：

このセッションを要約してください。重要な調査結果だけを短くまとめてください。

AI はセッションの結論、タグ付きの要点、分岐の結果を圧縮した要約を生成します。思考の連鎖全体を再生せずにコンテキストを読み込むのに役立ちます。

開発

npm install          # Install dependencies
npm run build        # Build TypeScript
npm run watch        # Watch mode
npm test             # Run tests with coverage
npm run test:unit    # Unit tests only
npm run test:integration  # Integration tests only

ライセンス

MIT

コントリビューション

github.com/BAM-DevCrew/MAXential-Thinking-MCP への Issue や PR を歓迎します。