cursor-explorer-mcp

Use for token-expensive operations requiring multi-file analysis - codebase exploration, broad searches, architecture understanding, tracing flows, finding implementations across files. Uses MCP cursor-agent server (company pays) with clean async interface. Do NOT use for single-file analysis, explaining code already in immediate context, or pure reasoning tasks.

1. Rozpoznaj moment, gdy Cursor Explorer się przyda: szukasz gdzie w kodzie znajduje się funkcja, chcesz zrozumieć jak działa system na wielu plikach, lub musisz prześledzić przepływ danych między modułami. Jeśli pytanie dotyczy jednego pliku lub odpowiedź zajmie 1–2 linijki, użyj zamiast tego standardowych narzędzi do czytania kodu.

2. Sformułuj zapytanie precyzyjnie, prosząc o konkretny format: numery linii, fragmenty kodu i wyjaśnienie celu każdego znaleziska. Możesz połączyć kilka powiązanych pytań w jedno zapytanie, aby zaoszczędzić czas.

3. Uruchom zapytanie przez cursor-agent, wywołując funkcję start z parametrem query zawierającym Twoje pytanie. System zwróci identyfikator query_id, który będzie potrzebny do pobrania wyniku.

4. Pobierz wynik, używając funkcji result z query_id i ustawieniem wait na true — serwer automatycznie czeka na zakończenie analizy, nie musisz ręcznie monitorować postęp.

5. Przeanalizuj zwrócone odniesienia i fragmenty kodu. Jeśli zapytanie się nie powiodło, nie ponawiaj — zamiast tego przełącz się na ręczne czytanie plików za pomocą standardowych narzędzi.

6. Przedstaw użytkownikowi znalezione wyniki z dokładnymi odniesieniami do plików i linii, aby mógł szybko nawigować po kodzie i zrozumieć strukturę projektu.