Zainstaluj i zapytaj w kilka minut.

Jak to działa

Twój asystent AI uruchamia na Twoim komputerze mały program: serwer MCP. Gdy pytasz o mieszkania, asystent prosi ten program o dane, program pobiera je z deweloperuch.pl i oddaje asystentowi, a asystent układa odpowiedź, zwykle w tabeli z linkami do źródeł.

MCP (Model Context Protocol) to otwarty standard, dzięki któremu asystenci AI mogą korzystać z zewnętrznych narzędzi i danych. deweloperuch-mcp daje im 13 narzędzi, które tylko czytają dane: niczego w serwisie nie tworzą ani nie zmieniają.

Nie zakładasz konta i nie potrzebujesz żadnego klucza. Projekt jest darmowy i otwarty (licencja MIT). To nieoficjalny projekt społeczności, który działa za zgodą autorów deweloperuch.pl.

Czego potrzebujesz

• Komputera z macOS albo Linuxem. Windows nie jest jeszcze obsługiwany.
• Asystenta AI, który uruchamia lokalne serwery MCP, np. aplikacji Claude Desktop albo Claude Code. Asystenci, którzy przyjmują tylko zdalne serwery MCP, na razie z niego nie skorzystają.
• Do instalacji przez terminal: programu uv (opis niżej). Rozszerzenie dla Claude Desktop go nie wymaga.

Program uv

uv to darmowy program, który pobiera i uruchamia narzędzia napisane w Pythonie. Nie musisz znać Pythona ani niczego konfigurować: wystarczy zainstalować uv raz. Potem komenda uvx deweloperuch-mcp sama pobierze i uruchomi serwer.

Instalacja uv

Otwórz aplikację Terminal (na Macu znajdziesz ją przez Spotlight: ⌘+spacja, wpisz „Terminal”), wklej tę komendę i naciśnij Enter:

Jeśli masz Homebrew, możesz też użyć:

Po instalacji zamknij okno terminala i otwórz nowe. Sprawdź, czy wszystko działa:

Komenda powinna wypisać numer wersji. Jeśli widzisz „command not found”, zajrzyj do rozwiązywania problemów.

Inne aplikacje i agenci AI

Claude Code

Jedna komenda w terminalu (wymaga uv):

Dowolna aplikacja obsługująca lokalne serwery MCP

Dodaj serwer w ustawieniach MCP swojej aplikacji. W Claude Desktop bez rozszerzenia jest to plik claude_desktop_config.json; inne aplikacje przyjmują to samo polecenie i argumenty:

{
  "mcpServers": {
    "deweloperuch": {
      "command": "uvx",
      "args": ["deweloperuch-mcp"]
    }
  }
}

Agent AI w terminalu: skill

Skill to gotowa instrukcja dla agenta kodującego (np. Claude Code, Codex, Cursor): podpowiada mu, których komend deweloperuch użyć i jak czytać wyniki. Instalacja wymaga Node.js:

Bez Node.js skill zainstaluje samo CLI. Domyślnie trafia do Claude Code (~/.claude/skills/deweloperuch-cli); dla innych agentów dodaj np. --agent cursor albo --agent codex:

Samo CLI

Komendę deweloperuch możesz uruchomić bez instalowania albo zainstalować na stałe:

Pierwsze pytania

Pisz tak, jak pytałbyś znajomego, który zna rynek. Kilka pytań na dobry początek:

• „Znajdź mieszkania 40–55 m² na krakowskim Podgórzu do 800 000 zł, od najtańszych za metr.”
• „Czy ta oferta to okazja? Pokaż historię ceny, najniższą cenę z 30 i 90 dni i czy obniżka nie wygląda podejrzanie.”
• „Co buduje ten deweloper i w których miastach ma aktywne oferty?”
• „Jak ceny ofertowe w Gdańsku mają się do cen transakcyjnych z ostatnich kwartałów?”
• „Ile mniej więcej jest wart 55-metrowy lokal pod tym adresem, na podstawie transakcji w okolicy?”
• „Uszereguj miasta według ceny transakcyjnej za m² i pokaż obok wynagrodzenia i bezrobocie.”

Trzy rodzaje cen

Narzędzia rozróżniają trzy rodzaje cen. Mówią o różnych rzeczach, więc asystent dostaje instrukcję, żeby ich nie mieszać:

• Ceny ofertowe: ile deweloperzy chcą dziś za mieszkania na rynku pierwotnym, z historią zmian cen.
• Ceny transakcyjne: za ile mieszkania naprawdę się sprzedały, według Rejestru Cen Nieruchomości (RCN). Najnowsze okresy bywają niepełne.
• Dane oficjalne: statystyki GUS i NBP, czyli tło rynku: ceny, mieszkania oddane do użytkowania, wynagrodzenia i bezrobocie.

Gotowe prompty

Prompty to gotowe polecenia, które wybierasz w aplikacji zamiast pisać pytanie od zera. Każdy prowadzi asystenta przez właściwe narzędzia w dobrej kolejności. Same niczego nie pobierają.

Narzędzia

Z narzędzi korzysta asystent, nie Ty: wystarczy, że zadasz pytanie. Ta lista przyda się, gdy chcesz wiedzieć, o co można zapytać. Opisy pochodzą prosto z serwera.

Komendy w terminalu

Każde narzędzie ma odpowiednik w komendzie deweloperuch. Dodaj --help do dowolnej komendy, żeby zobaczyć jej opcje, a --json, żeby dostać wynik jako JSON.

Limity i blokada STOP

Serwer jest „grzecznym klientem”: wysyła najwyżej jedno zapytanie na sekundę, jedno naraz, wspólnie dla wszystkich programów na Twoim komputerze, i pamięta odpowiedzi przez krótki czas.

Gdy serwis odpowie odmową (błąd 401, 403, 429) albo pokaże zabezpieczenie typu captcha, serwer włącza blokadę STOP i przestaje wysyłać zapytania: po błędzie 429 na chwilę (blokada sama wygasa), w pozostałych przypadkach do Twojej decyzji. Asystent zobaczy wtedy komunikat ze słowem STOP i powód.

Co zrobić przy blokadzie STOP

1. Sprawdź przyczynę:
   Terminal

   $ uvx --from deweloperuch-mcp deweloperuch stop status
2. Jeśli to chwilowe ograniczenie (429), odczekaj wskazany czas.
3. Gdy przyczyna jest jasna, zdejmij blokadę:
   Terminal

   $ uvx --from deweloperuch-mcp deweloperuch stop clear
4. Uruchom ponownie aplikację z asystentem: serwer po blokadzie potrzebuje restartu.

Rozwiązywanie problemów

„command not found: uvx”

uv nie jest zainstalowany albo terminal go jeszcze nie widzi. Zainstaluj uv i otwórz nowe okno terminala. Aplikację z asystentem uruchom ponownie, żeby też go zobaczyła.

Pierwsze uruchomienie trwa długo

To normalne: za pierwszym razem pobierane są potrzebne pliki. Trwa to zwykle około minuty, kolejne starty są szybkie.

Asystent nie widzi narzędzi

Uruchom aplikację ponownie i sprawdź, czy rozszerzenie albo serwer deweloperuch jest włączony w jej ustawieniach. W Claude Desktop na Macu dzienniki serwerów MCP są w katalogu ~/Library/Logs/Claude/ (pliki mcp-server-*.log).

„Następne zapytanie do deweloperuch.pl wolno wysłać dopiero za N s…”

Serwer pilnuje limitu zapytań. Odczekaj podany czas i zapytaj ponownie.

Wyniki są obcięte

Serwis pozwala przejrzeć najwyżej 20 stron wyników. Zamiast prosić o kolejne strony, zawęź pytanie: miasto, dzielnica, metraż, budżet.

Windows

Nie jest jeszcze obsługiwany: współdzielony limit zapytań korzysta z mechanizmu blokad plików, którego Windows nie ma.

Nadal nie działa?

Zgłoś problem na GitHubie. Opisz, jak instalowałeś serwer, w jakiej aplikacji i jaki komunikat widzisz.

Prywatność

Serwer działa na Twoim komputerze i łączy się wyłącznie z deweloperuch.pl, i to tylko po dane do odczytu. Przedstawia się serwisowi uczciwie, jako deweloperuch-mcp/<wersja> z linkiem do repozytorium. Nie zbiera danych o Tobie i niczego nie wysyła autorom projektu.

Twoje pytania trafiają do dostawcy Twojego asystenta AI na jego zasadach. Do deweloperuch.pl serwer wysyła tylko parametry potrzebne do pobrania danych (np. miasto, metraż, budżet).

Ta strona liczy wejścia i kliknięcia narzędziem Umami: bez cookies i bez zapisywania danych, które pozwalałyby Cię rozpoznać.

Pełna dokumentacja techniczna (po angielsku) jest w repozytorium na GitHubie.