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，將 mindpilot 添加到 MCP 配置中：

{
  "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 面板中點擊三個點 ...，然後點擊 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 客戶端啟動一個共享 Web 服務器。
• 其他助手自動連接到現有的服務器。
• 所有助手共享相同的圖表歷史記錄和 Web 界面。
• 最後一個 MCP 客戶端斷開連接一分鐘後，服務器將自動關閉。

這意味著你可以同時與多個 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 服務器

在你的編碼代理中配置 MCP 後，你可以發出諸如“創建關於 x 的圖表”之類的請求，它應該會使用 MCP 服務器在連接到 MCP 服務器的瀏覽器中為你渲染 Mermaid 圖表。

你可以選擇更新代理的規則文件，以給出何時使用 mindpilot-mcp 的具體說明。

示例請求

• “顯示 WebSocket 連接邏輯的狀態機”
• “創建此項目架構的 C4 上下文圖”
• “以序列圖形式顯示 OAuth 流程”

🔧 工作原理

前沿的大語言模型經過良好訓練，能夠生成有效的 Mermaid 語法。MCP 旨在接受 Mermaid 語法，並在運行於 http://localhost:4000（默認端口）的 Web 應用程序中渲染圖表。

🔧 故障排除

端口衝突

如果你將端口 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 時遇到問題（不僅僅是 mindpilot），你可能需要從主目錄設置一個“全局”的 Node.js 版本。

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

📄 許可證