mindforge

mindforge-mcp-server

stdio 経由で、Claude Code または任意の MCP ホストから、MindForge エンジンのナレッジグラフ、プロジェクトの健全性、監査ログを読み取ります。

AI エージェントに MindForge エンジンを公開する、自己完結型の Model Context Protocol（MCP）サーバーです。SQLite ベースのナレッジグラフを検索し、関連する記憶を見つけ、プロジェクトの健全性を確認し、改ざんを検知できる監査ログを読み取れます。さらに、新しい知識を保存するための、ガード付き書き込み機能も 1 つ備えています。実行時依存関係はゼロ（サーバーと依存関係は単一ファイルにバンドルされています）なので、クリーンインストール後でも、オフラインでも、最初のセッションから実行できます。

インストール

claude mcp add mindforge -- npx -y mindforge-mcp-server

または、MCP ホストの設定（Claude Desktop、Cursor、VS Code）に手動で追加します。

{
  "mcpServers": {
    "mindforge": {
      "command": "npx",
      "args": ["-y", "mindforge-mcp-server"],
      "env": { "CLAUDE_PROJECT_DIR": "${workspaceFolder}" }
    }
  }
}

サーバーはすべての操作を CLAUDE_PROJECT_DIR（.mindforge/ と .planning/ を含むプロジェクト）内に限定します。未設定の場合は、現在の作業ディレクトリを使用します。MindForge がプロジェクト内で初期化されていない場合、すべてのツールは実行可能な対処方法を示すメッセージを返し、適切に動作します。例外は発生しません。

ツール

ツール	アクセス	説明
mindforge_health	読み取り専用	現在のプロジェクトの MindForge ヘルスチェック（設定、状態、ナレッジグラフ、監査チェーン）を実行します。
mindforge_status	読み取り専用	現在のプロジェクトの状態、MindForge が初期化済みかどうか、アクティブなフェーズ、引き継ぎの状態を読み取ります。
mindforge_memory_query	読み取り専用	トピック、タグ、タイプを指定して、ナレッジグラフ（アーキテクチャ上の決定、パターン、好み）を検索します。
mindforge_memory_stats	読み取り専用	ナレッジグラフの統計情報（エントリーの合計数と有効な数、タイプ、タグの分布）を報告します。
mindforge_memory_find_related	読み取り専用	自由形式のテキストをもとに、ハイブリッド検索（FTS5 ＋ グラフ走査）で関連する知識エントリーを見つけます。
mindforge_audit_log	読み取り専用	改ざんを検知できる監査ログ（.planning/AUDIT.jsonl）のエントリーを読み取ります。イベントによる絞り込みも可能です。
mindforge_memory_remember	書き込み（ガード付き）	新しい知識エントリー（決定、パターン、好み）をグラフに保存します。
mindforge_browse	書き込み（ガード付き、オープンワールド）	MindForge ブラウザデーモンを操作します（状態確認／移動／クリック／入力／スクリーンショット／アサーション）。デーモンがすでに起動している必要があります（/mindforge:browse --start）。このツールがデーモンを起動することはなく、JS eval や Cookie のインポートも公開しません。

すべてのツールには readOnlyHint / destructiveHint の注釈が付いており、MCP ホストは適切な信頼境界を適用できます。書き込みを行うのは mindforge_memory_remember のみで、追記専用です。

トランスポートとセキュリティ

• トランスポート： stdio JSON-RPC（単一の組み込みクライアント）。
• スコープ： CLAUDE_PROJECT_DIR 内での読み取りと追記のみ。加えて、MindForge ブラウザデーモンへのループバック限定プロキシ（mindforge_browse）を使用します。シェル実行はありません。MCP サーバープロセス自体が通信するのは 127.0.0.1 のみです。実際のブラウザーのネットワーク通信は、ページ遷移時にデーモンが行います（デーモンは別途起動しておく必要があり、このサーバーが起動することはありません）。
• 自己完結型： SDK と Zod は dist/index.js にバンドルされているため、実行時に node_modules は不要です。

MindForge の一部

このサーバーは単体（npm ＋ MCP レジストリ）で配布されるほか、MindForge Claude Code プラグインにもバンドルされています。スラッシュコマンド、サブエージェント、ガバナンス、コストを考慮したモデルルーティングを含むフレームワーク全体については、メインリポジトリをご覧ください。

ライセンス

MIT © MindForge Team