Mindpilot MCP

🚀 Mindpilot MCP

Mindpilot MCPは、エージェントの視点からコードを可視化することができます。レガシーコードの可視化や複雑なフローの検査、コード全体の理解をサポートします。

✨ 主な機能

• あらゆるものを可視化: コーディングエージェントを使って、必要に応じてアーキテクチャ、コード、プロセスの図を生成し、様々な視点からコードを見ることができます。
• 品質チェック: AIによって生成されたコードには、未使用や冗長な構造が蓄積することがあります。可視化を使って、クリーンアップが必要な領域を特定できます。
• ローカル処理: 図はクラウドに送信されることはありません。すべてがあなた、エージェント、エージェントのLLMプロバイダ間で処理されます。
• エクスポートと共有: 任意の図をベクター画像としてエクスポートできます。

📦 インストール

前提条件

Node.js v20.0.0以上が必要です。

クイックスタート

Claude Code

claude mcp add mindpilot -- npx @mindpilot/mcp@latest

Cursor

Settings > Cursor Settings > MCP の下で Add new global MCP server をクリックし、mcpServers オブジェクトでmindpilotを設定します。

{
  "mcpServers": {
    "mindpilot": {
      "command": "npx",
      "args": ["@mindpilot/mcp@latest"]
    }
  }
}

VS Code

VS CodeでMCPを有効にするには、こちらの手順に従ってください: https://code.visualstudio.com/docs/copilot/chat/mcp-servers

Settings > Features > MCP に移動し、Edit in settings json をクリックします。 そして、MCP設定にmindpilotを追加します。

{
  "mcp": {
    "servers": {
      "mindpilot": {
        "type": "stdio",
        "command": "npx",
        "args": ["@mindpilot/mcp@latest"]
      }
    }
  }
}

Windsurf

Settings > Windsurf Settings > Manage Plugins の下で view raw config をクリックし、mcpServers オブジェクトでmindpilotを設定します。

{
  "mcpServers": {
    "mindpilot": {
      "command": "npx",
      "args": ["@mindpilot/mcp@latest"]
    }
  }
}

Zed

AI Threadパネルで3つのドット ... をクリックし、Add Custom Server... をクリックします。 Command to run MCPserver フィールドに npx @mindpilot/mcp@latest を入力し、Add Server をクリックします。

🔧 設定オプション

• ポート: サーバーはデフォルトでポート4000を使用しますが、--port コマンドラインスイッチを使って設定できます。
• データパス: デフォルトでは、図は ~/.mindpilot/data/ に保存されます。--data-path コマンドラインスイッチを使って、カスタムの場所を指定できます。

🔧 複数クライアントサポート

Mindpilotは、複数のAIアシスタントが同時に実行される場合を賢く処理します。複数のClaude DesktopウィンドウやIDEインスタンスを開いている場合:

• 最初にMindpilotを使用するmcpクライアントが共有ウェブサーバーを起動します。
• 追加のアシスタントは自動的に既存のサーバーに接続します。
• すべてのアシスタントは同じ図の履歴とウェブインターフェイスを共有します。
• 最後のMCPクライアントが切断されてから1分後に、サーバーは自動的にシャットダウンします。

これにより、ポートの競合なしに複数のMCPホストで同時に作業でき、すべてのアシスタントが同じ図のコレクションに貢献します。

🔧 匿名使用状況追跡

Mindpilot MCPは、製品の使用状況を理解し、ユーザー体験を改善するために、匿名の使用データを収集しています。

分析機能の無効化

匿名の使用データを共有したくない場合は、MCP設定に --disable-analytics フラグを追加することで、分析機能を無効にできます。

Claude Code:

claude mcp add mindpilot -- npx @mindpilot/mcp@latest --disable-analytics

その他のIDE: 設定のargs配列に "--disable-analytics" を追加します。

{
  "command": "npx",
  "args": ["@mindpilot/mcp@latest", "--disable-analytics"]
}

💻 使用例

コーディングエージェントでMCPを設定した後、「xに関する図を作成して」のようなリクエストを行うと、MCPサーバーを使ってMermaid図をレンダリングし、MCPサーバーに接続されたブラウザで表示します。

必要に応じて、エージェントのルールファイルを更新して、mindpilot-mcpを使用するタイミングに関する具体的な指示を与えることができます。

リクエストの例

• "WebSocket接続ロジックのステートマシンを表示して"
• "このプロジェクトのアーキテクチャのC4コンテキスト図を作成して"
• "OAuthフローをシーケンス図として表示して"

🔧 仕組み

最先端のLLMは、有効なMermaid構文を生成するように十分に訓練されています。MCPは、Mermaid構文を受け取り、http://localhost:4000（デフォルトポート）で実行されるウェブアプリで図をレンダリングするように設計されています。

🔧 トラブルシューティング

ポートの競合

ポート4000を別のサービスで使用している場合は、MCPを別のポートで使用するように設定できます。

Claude Codeの例:

claude mcp add mindpilot -- npx @mindpilot/mcp@latest --port 5555

カスタムデータパス

図をカスタムの場所に保存するには（例えば、クラウドストレージと同期するため）:

Claude Codeの例:

claude mcp add mindpilot -- npx @mindpilot/mcp@latest --data-path /path/to/custom/location

その他のIDE:

{
  "command": "npx",
  "args": ["@mindpilot/mcp@latest", "--data-path", "/path/to/custom/location"]
}

asdfの問題

バージョンマネージャとして asdf を使用しており、MCPが正常に動作しない場合は、ホームディレクトリから "global" なnodejsバージョンを設定する必要がある場合があります。

cd
asdf set nodejs x.x.x

🔧 開発設定

コーディングエージェントでMCPを設定します（この例では claude を使用）。

claude mcp add mindpilot -- npx tsx <path to...>/src/server/server.ts

MCPのエラーを表示する必要がある場合は、--debug フラグを付けて claude を実行します。

開発用クライアント（Vite）を起動して、開発中にホットモジュールリロードを行います。

npm run dev

開発用クライアントを開きます。

localhost:5173

📄 ライセンス

このプロジェクトは、こちらのライセンスの下で公開されています。