Mindpilot MCP

Agentnizin gözünden bakın. Legacy kodu görselleştirin, karmaşık akışları inceleyin, her şeyi anlayın.

Neden Mindpilot?

• Her Şeyi Görselleştirin: Kodlama agentinizi kullanarak talep üzerine mimari, kod ve process diyagramları oluşturun ve kodunuzu farklı perspektiflerden görüntüleyin.
• Vibe Kontrolleri: AI tarafından üretilen kod, kullanılmayan ve gereksiz yapılar biriktirebilir. Temizleme gerektiren alanları spot etmek için görselleştirmeleri kullanın.
• Yerel İşleme: Diyagramlar asla buluta gönderilmez. Her şey sizin, agentiniz ve agentinizin LLM sağlayıcı(ları)nız arasında kalır.
• Dışa Aktar ve Paylaş: Herhangi bir diyagramı vektör görüntü olarak dışa aktarın.

Ön Koşullar

Node.js v20.0.0 veya daha yüksek.

Hızlı Başlangıç

Claude Code

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

Cursor

Settings > Cursor Settings > MCP altında, Add new global MCP server öğesine tıklayın ve mindpilot öğesini mcpServers nesnesinde yapılandırın.

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

VS Code

VS Code'da MCPları etkinleştirmek için buradaki talimatları izleyin: https://code.visualstudio.com/docs/copilot/chat/mcp-servers

Settings > Features > MCP öğesine gidin, ardından Edit in settings json öğesine tıklayın

Daha sonra mindpilot öğesini MCP konfigürasyonunuza ekleyin:

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

Windsurf

Settings > Windsurf Settings > Manage Plugins altında, view raw config öğesine tıklayın ve mindpilot öğesini mcpServers nesnesinde yapılandırın:

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

Zed

AI Thread panelinde üç nokta ... öğesine tıklayın, ardından Add Custom Server... öğesine tıklayın

Command to run MCPserver alanına npx @mindpilot/mcp@latest girin ve Add Server öğesine tıklayın.

Konfigürasyon Seçenekleri

• Port: Server varsayılan olarak 4000 portunda çalışır ancak --port komut satırı anahtarı kullanılarak yapılandırılabilir.
• Data Path: Varsayılan olarak, diyagramlar ~/.mindpilot/data/ öğesine kaydedilir. --data-path komut satırı anahtarını kullanarak özel bir konum belirtebilirsiniz.

Multi-Client Desteği

Mindpilot, eşzamanlı olarak çalışan birden fazla AI yardımcısını akıllıca yönetir. Birden fazla Claude Desktop penceresi veya IDE örneği açık olduğunda:

• Mindpilot'u kullanan ilk MCP client'ı paylaşılan bir web sunucusu başlatır
• Ek yardımcılar otomatik olarak mevcut sunucuya bağlanır
• Tüm yardımcılar aynı diyagram geçmişini ve web arayüzünü paylaşır
• Server, son MCP client'ı bağlantısını kestikten bir dakika sonra otomatik olarak kapatılır

Bu, birden fazla MCP host'u aynı anda port çatışmaları olmadan kullanabileceğiniz ve hepsinin aynı diyagram koleksiyonuna katkıda bulunabileceği anlamına gelir.

Anonim Kullanım İzlemesi

Mindpilot MCP, ürünün nasıl kullanıldığını anlamamıza ve kullanıcı deneyimini geliştirmemize yardımcı olmak için anonim kullanım verileri toplar.

Analitiği Devre Dışı Bırakma

Anonim kullanım verilerini paylaşmamayı tercih ederseniz, MCP konfigürasyonunuza --disable-analytics bayrağını ekleyerek analitiği devre dışı bırakabilirsiniz:

Claude Code:

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

Diğer IDE'ler: Konfigürasyonunuzda args dizisine "--disable-analytics" ekleyin:

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

MCP sunucusunu kullanma

Kodlama agentinizde MCP'yi yapılandırdıktan sonra, "x hakkında bir diyagram oluştur" gibi isteklerde bulunabilirsiniz ve MCP sunucusuna bağlı bir tarayıcıda Mermaid diyagramlarını işlemek için MCP sunucusunu kullanmalıdır.

Mindpilot-mcp'yi ne zaman kullanacağınız hakkında belirli talimatlar vermek için agentinizin kural dosyasını isteğe bağlı olarak güncelleyebilirsiniz.

Örnek istekler

• "WebSocket bağlantısı mantığı için durum makinesini göster"
• "Bu projenin mimarisi için bir C4 context diyagramı oluştur."
• "OAuth akışını bir sequence diyagram olarak göster"

Nasıl Çalışır

Frontier LLM'leri, geçerli Mermaid söz dizimi oluşturmak için iyi eğitilir. MCP, Mermaid söz dizimini kabul etmek ve http://localhost:4000 (varsayılan port) üzerinde çalışan bir web uygulamasında diyagramları işlemek için tasarlanmıştır.

Sorun Giderme

Port Çatışmaları

4000 portunu başka bir hizmet için kullanıyorsanız, MCP'yi farklı bir port kullanacak şekilde yapılandırabilirsiniz.

Claude Code örneği: claude mcp add mindpilot -- npx @mindpilot/mcp@latest --port 5555

Özel Data Path

Diyagramları özel bir konuma kaydetmek için (örneğin, bulut depolama ile senkronizasyon için):

Claude Code örneği: claude mcp add mindpilot -- npx @mindpilot/mcp@latest --data-path /path/to/custom/location

Diğer IDE'ler:

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

asdf Sorunları

Eğer asdf'yi bir sürüm yöneticisi olarak kullanıyorsanız ve MCPları çalıştırmakta sorun yaşıyorsanız (sadece mindpilot değil), ev dizininizden "global" bir nodejs sürümü ayarlamanız gerekebilir.

cd
asdf set nodejs x.x.x

Geliştirme Konfigürasyonu

MCP'yi kodlama agentinizde yapılandırın (bu örnekte claude kullanarak)

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

MCP hatalarını görmek için gerekliyse claude öğesini --debug bayrağı ile çalıştırın

Geliştirme sırasında hot module reloading almak için development client'ını (Vite) başlatın.

npm run dev

Development client'ını açın localhost:5173