Claude Debugs For You

Vibe Debugging olarak da bilinir

Claude'u (veya başka bir LLM'yi) kodunuzu interaktif olarak debug etmeyi sağlayın

Bu bir MCP Server ve VS Code uzantısıdır ve claude'un kodu interaktif olarak debug etmesini ve ifadeleri değerlendirmesini sağlar.

Bu, diğer modellerle / istemcilerle vb. çalışması gerektiği anlamına gelir, ancak burada bunu yalnızca Claude Desktop ve Continue ile gösterdim.

Dil-agnostiktir ve debugger console desteği ile VSCode'da debugging için geçerli launch.json dosyasını varsayar.

Başlangıç

Uzantıyı releases veya VS Code Marketplace'ten indirin
Uzantıyı kurun

.vsix dosyasını doğrudan kullanıyorsanız, VS Code'daki "Extensions"teki üç noktaya tıklayın ve "Install from VSIX..." seçeneğini seçin

Düzgün çalışıp çalışmadığını gösteren (işaret) veya başlatma başarısız oldu (x) gösteren yeni bir durum menüsü öğesi "Claude Debugs For You" göreceksiniz

Bu durum menüsünü tıklayarak kullanılabilir komutları görebilirsiniz

Kurulumunuza bağlı olarak aşağıdaki seçeneklerden birini izleyin

stdio kullanıyorsanız (klasik, Claude Desktop için gerekli)

VS Code komutlarında "Copy MCP Debug Server stdio path to clipboard" araması yaparak stdio sunucu yolunu panonuza kopyalayın
Aşağıdakileri yapıştırın (AMA YOL KOPYALANAN OLANA GÜNCELLEYIN!) claude_desktop_config.json dosyanıza veya diğer MCP sunucuları kullanıyorsanız buna göre düzenleyin

{
  "mcpServers": {
    "debug": {
      "command": "node",
      "args": [
        "/path/to/mcp-debug.js"
      ]
    }
  }
}

Claude desktop'ı başlatın (veya diğer MCP istemcisini)
1. Not: Zaten çalışıyorsa yeniden başlatmanız gerekebilir.
2. Continue/Cursor veya VS Code'a yerleşik diğer araçları kullanıyorsanız bu adımı atlayabilirsiniz

/sse kullanıyorsanız (örn. Cursor)

"Copy MCP Debug Server sse address to clipboard" komutunu kullanarak MCP sunucu sse adresini alın
1. Basitçe "http://localhost:4711/sse" sunucu URL'sini yazabilirsiniz veya ayarlarda kurduğunuz başka bir port
İstemcinize göre gerekli yere ekleyin
1. İstemciye bağlı olarak "refresh" tuşuna basmanız gerekebilir: bu Cursor'da gereklidir
MCP istemcisini başlatın
1. Not: Zaten çalışıyorsa yeniden başlatmanız gerekebilir.
2. Continue/Cursor veya VS Code'a yerleşik diğer araçları kullanıyorsanız bu adımı atlayabilirsiniz

Debug etmeye hazırsınız!

VS Code Debugging Dokumentasyonu

.vscode/launch.json içeren bir proje açın ve ilk konfigürasyon ${file} ile belirli bir dosyayı debug etmeyi sağlayacak şekilde kurulmuş olsun.

Aşağıdaki Bir Örneği Çalıştır bölümüne bakın ve/veya bir demo videosu izleyin.

Katkı Sağlama

Hata buldu veya bunu geliştirecek bir fikriniz mi var? Lütfen bir pull request açın veya bir issue kaydedin.

Bu readme kötü mü? Onu iyileştirmeme yardım edin!

Demo

Continue kullanarak

Sorunu anlar ve sonra bir düzeltme önerir, biz de onu uygulamak için tıklarız

https://github.com/user-attachments/assets/3a0a879d-2db7-4a3f-ab43-796c22a0f1ef

Bunu Continue ile nasıl kurarım? / MCP Konfigürasyonunu Göster

Dokümantasyonu oku!

Konfigürasyon:

{
  ...
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "node",
          "args": [
            "/Users/jason/Library/Application Support/Code/User/globalStorage/jasonmcghee.claude-debugs-for-you/mcp-debug.js"
          ]
        }
      }
    ]
  }
}

Ayrıca araçları kullanabilen bir modeli seçmeniz gerekecek.

Araçlar listesi açılır sayfada, araçlar listenizde "debug" seçeneğini tıkladığınızdan ve bunu "Automatic" olarak ayarladığınızdan emin olun.

Sorun Giderme

Continue'de MCP hataları görüyorsanız, continue eklentisini devre dışı bırakmayı / etkinleştirmeyi deneyin

Yararlı olabilirse, benim konfigürasyonum böyle görünüyor! Ama Claude Desktop ile neredeyse aynı.

Claude Desktop Kullanarak

Bu örnekte, bunu kasıtlı olarak çok temkinli yapdum (hiçbir varsayım yapma vb - aşağıdaki aynı prompt) ama istediğiniz herhangi bir şeyi yapmasını isteyebilirsiniz.

https://github.com/user-attachments/assets/ef6085f7-11a2-4eea-bb60-b5a54873b5d5

Geliştirme

Bu repo'yu klonlayın / VS Code'da açın
npm run install ve npm run compile çalıştırın
"run"a basın, bu yeni bir VSCode açacaktır
Aksi takdirde "Başlangıç" ile aynıdır
Yeniden oluşturmak için, npm run compile

Paket

vsce package

Bir Örneği Çalıştır

VS Code penceresinde examples/python açın

Prompt'u girin:

i am building `longest_substring_with_k_distinct` and for some reason it's not working quite right. can you debug it step by step using breakpoints and evaluating expressions to figure out where it goes wrong? make sure to use the debug tool to get access and debug! don't make any guesses as to the problem up front. DEBUG!

Belirtilmeye değer diğer şeyler

Birden fazla vs code penceresini başlattığınızda, bir açılır pencere göreceksiniz. "Claude Debugs For You"yu pencereler arasında nazikçe aktarabilirsiniz.

Ayrıca otomatik başlatmayı devre dışı bırakabilirsiniz. Sonra durum menüsünü tıklamanız ve "Start Server" seçmeniz yeterli olacaktır.

Kısa fikir listesi

[ ] Dosyaları listele + dosya içeriğini al yerine, sizin istediğinizi bulmak için ripgrep kullanmalıdır.
[x] Koşullu breakpoint desteği ekleyin
[ ] MCP'nin bir CodeLens veya "otomatik düzeltme" önerisi eklemesine izin vererek "düzeltme" aracı ekleyin, böylece kullanıcı önerilen bir değişikliği uygulamayı seçebilir veya seçmeyebilir.
Sizin fikriniz burada!

jasonjmcghee/claude-debugs-for-you

Bu MCP sunucusu hakkında