desktop_commander_mcp

Desktop Commander MCP – sterowanie Twoim komputerem

Otwarte i darmowe

Add to Cart

Desktop Commander to serwer MCP, który daje Twojemu asystentowi AI (np. Claude) prawdziwe „cyfrowe ręce” do działania na Twoim komputerze. Zamiast ciągle kopiować pliki i wklejać ich zawartość do czatu, pozwalasz AI pracować bezpośrednio na folderach, arkuszach Excela, PDF-ach, a nawet w terminalu. Dzięki temu sztuczna inteligencja przestaje być tylko doradcą — staje się wykonawcą, który potrafi ogarnąć konkretne zadania: uporządkować Pobrane, przeanalizować arkusze bez otwierania ich ręcznie czy zainstalować potrzebne narzędzia. Co dostajesz w praktyce?
  • Zarządzanie plikami (Filesystem): AI może tworzyć, odczytywać, edytować oraz przenosić pliki i foldery na Twoim dysku.
  • Obsługa Excela i PDF: możliwość pracy z plikami .xlsx (czytanie i edycja) oraz tworzenie i odczyt dokumentów PDF bezpośrednio przez asystenta.
  • Terminal i procesy: AI może wpisywać komendy systemowe, uruchamiać programy i zarządzać procesami — na przykład zamknąć zawieszoną aplikację.
  • Edycja kodu (Smart Edit): precyzyjne zmiany w plikach tekstowych i kodzie, w stylu „znajdź i zamień”, bez ryzyka rozjechania reszty pliku.
  • Wyszukiwanie (Search): szybkie przeszukiwanie folderów i zawartości plików, żeby wyciągnąć informacje nawet wtedy, gdy są schowane głęboko w strukturze katalogów.
ℹ️ Desktop Commander działa lokalnie na Twoim sprzęcie, więc to Ty decydujesz, na co AI ma dostęp i co może zrobić. Dla dodatkowego bezpieczeństwa możesz uruchomić go w odizolowanym środowisku, np. w Dockerze.
Pomyśl o tym tak: asystent AI siedzi obok Ciebie przy komputerze. Zamiast przepisywać mu treść dokumentu, po prostu mówisz, który plik ma wziąć na warsztat. Desktop Commander działa jak bezpieczny „most” między czatem a Twoim dyskiem, dzięki czemu AI może faktycznie dotknąć plików i wykonać zadanie na miejscu. Jak to wygląda krok po kroku?
  • Ty: piszesz polecenie w czacie, np. „Przeanalizuj plik budżet.xlsx na pulpicie i zrób podsumowanie”.
  • AI: wysyła prośbę do Desktop Commandera o odczyt wskazanego pliku.
  • Desktop Commander: otwiera Excela w tle, pobiera dane i przekazuje je z powrotem do AI — zwykle trwa to chwilę.
  • Wynik: asystent odpowiada na podstawie realnych informacji z Twojego komputera, bez ręcznego wrzucania plików do chmury.
Co możesz dzięki temu zrobić w praktyce?
  • Automatyzacja biurowa: „Przejrzyj Dokumenty, znajdź wszystkie faktury PDF z zeszłego miesiąca i przenieś je do Księgowość/Maj”.
  • Analiza danych: masz ciężki arkusz, który potrafi zamrozić Excela? AI może go odczytać przez MCP i wyłuskać wnioski bez otwierania programu.
  • Programowanie i konfiguracja: „Sprawdź, czy mam Pythona. Jeśli nie — zainstaluj, a potem utwórz prosty skrypt do sortowania zdjęć”.
💡 Wskazówka: dzięki „Session management” asystent pamięta, co już zrobił w terminalu. To ułatwia dłuższe, wieloetapowe zadania — bez cofania się, powtarzania komend i gubienia kontekstu.

Instalacja i konfiguracja

Desktop Commander oferuje kilka sposobów instalacji, dostosowanych do Twoich potrzeb i poziomu zaawansowania. Ważna uwaga: Opcje instalacji przez npx, skrypt dla macOS, Smithery oraz Docker aktualizują się automatycznie.

1. Claude Desktop (Instalacja przez npx – najprostsza)

Jest to najszybsza metoda, jeśli masz już zainstalowane środowisko Node.js na swoim komputerze.
  1. Otwórz okno poleceń (terminal).
  2. Wpisz i uruchom poniższe polecenie:
npx @wonderwhy-er/desktop-commander@latest setup
  1. Uruchom ponownie aplikację Claude Desktop. Wtyczka zaktualizuje się automatycznie przy każdym restarcie aplikacji.

2. Claude Desktop (Ręczna konfiguracja JSON)

Jeśli wolisz mieć pełną kontrolę lub instalacja automatyczna zawiodła, możesz ręcznie edytować plik konfiguracyjny.
  1. Znajdź plik claude_desktop_config.json:
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  2. Otwórz go w notatniku i dodaj poniższy kod w sekcji mcpServers:
{
"mcpServers": {
"desktop-commander": {
"command": "npx",
"args": [
"-y",
"@wonderwhy-er/desktop-commander@latest"
]
}
}
}
  1. Zapisz plik i zrestartuj Claude Desktop.

3. Instalacja przez Docker (Maksymalne bezpieczeństwo)

Ta metoda tworzy całkowicie odizolowane środowisko (“piaskownicę”). Jest idealna, jeśli obawiasz się, że AI mogłoby coś zepsuć w Twoim głównym systemie. Nie wymaga instalacji Node.js, ale musisz mieć zainstalowany program Docker Desktop.
  1. Upewnij się, że aplikacja Docker Desktop jest uruchomiona.
  2. Otwórz okno poleceń (np. PowerShell na Windows lub Terminal na macOS).
  3. Dla systemu Windows (PowerShell) uruchom to polecenie:
iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.ps1'))
  1. Dla systemu macOS/Linux uruchom to polecenie:
bash <(curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.sh)
  1. Skrypt poprosi Cię o wybranie folderów, do których AI ma mieć dostęp. Skonfiguruje również aplikację Claude. Na koniec zrestartuj Claude Desktop.
💡 Wskazówka: Jeśli nie wiesz od czego zacząć po instalacji, po prostu napisz do AI: “Help me get started with Desktop Commander”. Asystent pokaże Ci proste przykłady użycia.

Rozwiązywanie problemów

  • Jak odinstalować wtyczkę? Najprościej otworzyć terminal i wpisać: npx @wonderwhy-er/desktop-commander@latest remove. Narzędzie to automatycznie usunie wpisy z konfiguracji Claude i zrobi kopię zapasową starych ustawień.
  • Claude nie chce się uruchomić po ręcznej instalacji: Prawdopodobnie zrobiłeś błąd (np. brakujący przecinek) podczas edycji pliku claude_desktop_config.json. Otwórz go ponownie i sprawdź dokładnie strukturę JSON.

Czy to jest bezpieczne? Czy AI nie usunie moich plików?

Desktop Commander daje duże możliwości, ale Ty masz kontrolę. AI nie zrobi niczego bez Twojego polecenia. Dodatkowo możesz skonfigurować tzw. “allowedDirectories” (dozwolone foldery), aby ograniczyć dostęp asystenta tylko do konkretnych miejsc na dysku.

Czy muszę znać się na programowaniu, żeby tego używać?

Nie. To jest właśnie największa zaleta Desktop Commander. Możesz używać naturalnego języka (np. „zrób listę plików w tym folderze”), a AI sama przetłumaczy to na odpowiednie komendy techniczne.

Czy mogę pracować na plikach Excela i PDF?

Tak! To jeden z niewielu serwerów MCP, który natywnie obsługuje pliki .xlsx oraz PDF. Możesz prosić o analizę danych z arkuszy, edycję komórek czy wyciąganie tekstu z dokumentów PDF.

Czym jest opcja instalacji Docker?

To opcja dla zaawansowanych użytkowników, którzy chcą maksymalnego bezpieczeństwa. Uruchamia ona serwer w „piaskownicy” (izolowanym środowisku). Nawet jeśli AI popełni błąd i spróbuje usunąć system, stanie się to tylko wewnątrz bezpiecznego kontenera, a Twój prawdziwy system pozostanie nienaruszony.

SZYBKA INSTALACJA

Code 
{
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander@latest"
      ]
    }
  }
}