Siedem pytań, które należy zadać przed uruchomieniem lokalnego serwera MCP
Lista kontrolna dla izolacji lokalnych serwerów MCP, opracowana na serwerze GitHub: krótkotrwałe tokeny, zabezpieczona sieć, lista uprawnień do wyjścia oraz spersonalizowane listy narzędzi.
Źródła: the seven questions i ask before running a local mcp server — part 2
Instalacja lokalnego serwera MCP zazwyczaj oznacza wklejenie fragmentu kodu do pliku konfiguracyjnego:
{
"mcpServers": {
"some-tool": { "command": "npx", "args": ["-y", "some-mcp-server"] }
}
}
To trzy linijki kodu – bez recenzji, bez okna z prośbą o uprawnienia i bez kroku instalacji, o którym ktoś w ogóle myśli. Warto zatrzymać się i zastanowić, co te linijki robią. Lokalny serwer MCP nie jest usługą; nie ma portu, żadnego logowania ani żadnych ograniczeń. To program, który agent uruchamia, działający jako bieżący użytkownik i mający dostęp do plików oraz środowiska tego użytkownika. Okno z prośbą o uprawnienia, które wyświetla agent, pokazuje, co robi agent, podczas gdy program za pośrednictwem wywołania narzędzia ma już pełną kontrolę nad maszyną.
Lepszym nawykiem jest zadanie siedmiu pytań przed instalacją i pozostawienie odpowiedzi na określenie konfiguracji.
Siedem pytań
- Czy działa lokalnie? Serwery MCP zdalne znajdują się na maszynie third party i nie można ich zamknąć w określonych ramach, co sprawia, że reszta listy traci sens. Czasami jest to decyzja, a nie fakt niezmienny, a staranne wybór między wersją zdalną a lokalną może sprawić, że pozostałe sześć pytań przestanie być istotnych.
- Czy wymaga danych uwierzytelniających? Albo żadnych, albo konkretnych, których można podać nazwę.
- Do czego się łączy? Albo do krótkiej, stałej listy hostów, albo do dowolnego adresu URL.
- Które pliki są potrzebne? Jeden obszar roboczy, wszystko lub nic.
- Czy wymaga czegoś jeszcze od hosta? Sesji pulpitu, gniazda sieciowego, przeglądarki.
- Czy uruchamia kod, który pobiera? Jeśli tak, ten kod wymaga zabezpieczenia.
Na pytania od pierwszego do szóstego można odpowiedzieć na podstawie własnej dokumentacji serwera w około dziesięć minut, bez konieczności przeszukiwania źródeł. Tylko na siódme pytanie istnieje konkretna miara: wystarczy jedna wywołanie tools/list po instalacji, a liczba narzędzi często przekracza oczekiwania.
Przykład zastosowania: serwer GitHub
| Pytanie | Odpowiedź dla serwera GitHub |
|---|---|
| Czy działa lokalnie? | Tak, jest dostarczany już jako obraz kontenera |
| Dane logowania | Są wymagane, ponieważ prywatne repozytoria nie można odczytywać anonimowo |
| Do czego się łączy? | Do jednego hosta, api.github.com |
| Pliki | Brak niczego poza kluczem. Praca odbywa się przez API, więc na dysku nie ma żadnego klonu ani pliku checkout |
| Inne wymagania hosta | Nic |
| Ładowanie kodu w czasie wykonywania | Nie |
| Lista narzędzi | Można ją zmniejszyć za pomocą --toolsets i --exclude-tools |
Podsumowując, odpowiedzi określają konfigurację: jeden klucz dostępu, brak folderu zamontowanego, jedno miejsce docelowe oraz lista narzędzi, którą należy uprościć.
Klucz dostępu stanowi trudniejszy element, ponieważ nie można go usunąć z projektu. Jeśli agent otwiera prośby o pull request, musi mieć dostęp do zapisu. Zamiast tego stosuje się ograniczenia, począwszy od używania GitHub App zamiast osobistego tokena dostępu:
{
"mcpServers": {
"github": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--network",
"mcp-egress-github",
"--read-only",
"--tmpfs",
"/tmp",
"--cap-drop",
"ALL",
"--security-opt",
"no-new-privileges",
"--user",
"10001:10001",
"--log-driver",
"journald",
"-e",
"HTTPS_PROXY=http://mcp-egress-proxy:3128",
"-e",
"HTTP_PROXY=http://mcp-egress-proxy:3128",
"-v",
"/home/<user>/.config/mcp-gh/<app>.private-key.pem:/key.pem:ro",
"ghcr.io/github/github-mcp-server@sha256:508a0857ec762b1ab1cece29193345b501fab1dd9d1228a7b617062954cecac6",
"stdio",
"--app-id",
"NNNNNNN",
"--app-installation-id",
"NNNNNNNNN",
"--app-private-key-path",
"/key.pem",
"--toolsets",
"context,issues,pull_requests,repos",
"--exclude-tools",
"create_repository,fork_repository,get_teams,get_team_members,list_repository_collaborators"
]
}
}
}
K warstwach otaczających tę uwierzytelniającą informację
- Tokeny krótkotrwałe. Aplikacja GitHub App wytwarza tokeny, które szybko wygasają.
- Montowanie tylko do odczytu. Klucz podpisywania jest montowany tylko do odczytu i należy do UID, do którego mapuje się kontener, a nie do użytkownika. Nie znajduje się on w katalogu
~/.ssh, gdzie nie byłby ani kluczem SSH, ani dostępnym dla użytkownika. - Kontenery bez uprawnień administratora. Demon Docker działa w trybie bez uprawnień root, proces używa użytkownika innej niż root osoby, a nie przyznawane są żadne dodatkowe uprawnienia.
- Jeden repozytorium, cztery uprawnienia. Dla elementów
contents,issuesipull_requestsprzysługują uprawnienia do zapisu, dlametadatauprawnienia do odczytu, a każdy wytworzony token posiada dokładnie te uprawnienia. - Zamknięta sieć. Nie ma bezpośredniej drogi na zewnątrz, więc jedyną możliwością jest użycie proxy.
- Lista uprawnień wyjścia. Wszystko, co zostanie stworzone wewnątrz kontenera, może być wysyłane tylko do
api.github.com. - Zakotwiczone zestawy narzędzi, a następnie wykluczone narzędzia. Parametr
--toolsetsblokuje całe grupy, natomiast--exclude-toolsusuwa to, co pozostaje w utrzymanych grupach.
Ostatnie dwa rozwiązania rzadko przyciągają uwagę. Redukcja listy narzędzi to najniższy poziom uprawnień, który nadal umożliwia dostęp do zapisu. Lista uprawnień chroni nie tylko pliki lokalne, ponieważ ogranicza miejsca, w których mogą zostać wykorzystane skradzione dane uwierzytelniające.
To twierdzenie wymaga pomiaru. Dzięki --toolsets context,issues,pull_requests,repos serwer udostępnia 42 narzędzia. Pięć z nich nie może być używanych przy tych uprawnieniach. Po użyciu --exclude-tools pozostaje 37 narzędzi, z których 15 umożliwia zapisywanie danych. Ponieważ --toolsets wybiera całe grupy, repos włącza również create_repository i fork_repository, niezależnie od tego, czy token ma do nich dostęp. 37 to nie mała liczba, ale jest uczciwa i pokazuje, jak wyglądają minimalne uprawnienia, gdy agent rzeczywiście musi wysłać gałąź.
Dlaczego lista uprawnień nie jest przesadna
Na początku lista dopuszczalnych adresów wydaje się zbyt rozbudowana, dopóki ktoś nie zada pytania, czemu ma to służyć. Nikt nie może zmusić kontenera do nawiązania połączenia z attacker.com, więc token utworzony w nim nie ma dokąd udać się w środowisku wrogim. Rejestr proxy zapisuje oba wyniki każdej próby:
10.123.2.3 TCP_TUNNEL/200 CONNECT api.github.com:443 HIER_DIRECT/140.82.121.6
10.123.2.3 TCP_DENIED/403 CONNECT example.com:443 HIER_NONE/-
Flaga -e HTTPS_PROXY nie jest tym, co to wymusza. Linux nie posiada wbudowanej koncepcji proxy, ani przełącznika w jądrze, ani hooka w bibliotece libc. Zmienna ta jest jedynie tekstem w środowisku, a każdy klient HTTP decyduje sam, czy ją uwzględnić. Moduł net/http w Go ją uwzględnia, więc ten konkretny serwer nie wymaga dodatkowych działań. Wbudowany mechanizm fetch w Node jej nie uwzględnia, co oznacza, że serwer Node całkowicie zignoruje to ustawienie. Ochroną jest struktura sieci: przy braku trasy wyjściowej klient, który ignoruje tę zmienną, nie łączy się bezpośrednio, lecz po prostu zgłasza błąd. W sieci z trasą to samo zaniedbanie mogłoby spowodować wyciek ruchu bez żadnego ostrzeżenia.
Sprawdzenie zgodności z OWASP MCP Top 10
Mapowanie tej konfiguracji na OWASP MCP Top 10 oznacza każde ryzyko jako rozwiązane, pozostałe i kontrolowane, nierozwiązane lub nieważne dla lokalnego serwera stdio, z adnotacjami dotyczącymi tego, co pozostaje nierozwiązane.
Co nadal nie jest w zakresie
Żaden sandbox nie jest nigdy kompletny. Trzy tematy całkowicie wykraczają poza tę konfigurację: zdalne serwery MCP, serwery pobierające dowolne adresy URL oraz sam model.
Po tym momencie problem nie jest już zapomnianym elementem. Wszystkie te środki kontroli mają zastosowanie do każdego kontenera, są wpisywane ręcznie i muszą być kopiowane dla każdego dodawanego serwera. Trzy serwery wymagają trzech list pozwalających oraz trzech ciągów znaków dla zestawu narzędzi, a żaden komponent nie monitoruje sesji jako całości.
Brakuje bramy umieszczonej pomiędzy agentem a jego serwerami. Brama może całkowicie usunąć narzędzie z list_tools i ponownie sprawdzić każde żądanie przed przekazaniem go dalej, dzięki czemu lista narzędzi jest aktualizowana na bieżąco w trakcie sesji, a nie na podstawie pliku konfiguracyjnego. Nadal nie może jednak obserwować zachowania działającego serwera: otwieranych plików, kontaktowanych hostów czy czytanych danych uwierzytelniających. Zainfekowany serwer nie potrzebuje żadnego wywołania narzędzia, aby wysłać klucze w inne miejsce. Brama dodaje kolejną warstwę, nie usuwając żadnej z istniejących.
Zasady obowiązujące na każdym lokalnym serwerze
Podane powyżej odpowiedzi dotyczą GitHuba. Zasady, które stamtąd pochodzą, mają zastosowanie do każdego lokalnego serwera, który ma zostać wklejony do pliku konfiguracyjnego:
- Wolimy dane uwierzytelniające, które wygasają. Aplikacja GitHuba jest lepsza od osobistego tokena dostępu. Kontener przechowuje klucz podpisywania i tworzy nowy token przy każdym użyciu, a ten token wygasa sam z siebie, bez konieczności czekania na jego anulowanie przez kogoś innego.
- Określaj zakres uprawnień, a nie tylko dane uwierzytelniające. Jeden repozytorium i cztery uprawnienia – każdy token zawiera dokładnie te same.
- Zamknij sieć. Ponieważ nie ma żadnej domyślnej trasy, proxy nie jest ustawieniem, którego serwer mógłby odrzucić, podczas gdy
-e HTTPS_PROXYto jedynie prośba. - Utwórz listę dozwolonych destynacji. Jeden host,
api.github.com. Dane uwierzytelniające skradzione z tego kontenera nie mogą być użyte nigdzie indziej, a każda próba zostanie zapisana w dzienniku w obu przypadkach.
--user 10001, usuń możliwości specjalne za pomocą --cap-drop ALL, dodaj --security-opt no-new-privileges oraz zamontuj system plików w trybie --read-only z użyciem tmpfs do przechowywania plików tymczasowych./key.pem:ro, bez żadnego przestrzeni roboczej. Powiązanie $HOME z kontenerem nie stanowi zabezpieczenia typu sandboxing.--toolsets wyklucza określone grupy, a --exclude-tools usuwa pozostałe narzędzia, co zmniejsza liczbę narzędzi na tym serwerze z 42 do 37, przy czym 15 z nich nadal może wykonywać operacje zapisu.latest, a także tagów wersji, ponieważ tagi mogą być zmieniane. Obie obrazy w tym ustawieniu, włączając proxy, używają formatu @sha256:…, dzięki czemu nie mogą ulec zmianie.Żadna pojedyncza zasada nie określa, czy dojdzie do uszkodzenia. Zatruty dokument nadal może przekonać agenta do wywołania narzędzia. Każda zasada ogranicza zasięg rozprzestrzeniania się skutków, ale żadna nie blokuje samego wyzwalacza. Sandbox określa, gdzie program może komunikować się, ale nie to, co mówi.
Lista dozwolonych adresów ilustruje ten limit. Sprawdza ona, czy ruch trafia do api.github.com, ale nie ujawnia nic na temat zawartości. Opcja contents: write umożliwia agencie dodanie gałęzi, a także pozwala na wprowadzenie instrukcji służącej do zapisania pliku. Nazwy gałęzi, komunikaty zapisu oraz tytuły zadań wydają się w porządku pojedynczo, ale łączone mogą umożliwić wprowadzenie czegokolwiek do repozytorium, które inni mogą odczytać. Każdy filtr na tyle permissywny, by agencja mogła działać, pozwala na wyprowadzanie danych, ponieważ sama praca polega na odczytywaniu i zapisywaniu treści na GitHubie.
Dlatego traktuj to wszystko jako punkt wyjścia, a nie metę, i umieść to na początku. Koszt to siedem pytań, około dziesięciu minut na lekturę oraz jedna wywołanie funkcji tools/list. W zamian otrzymujemy konfigurację, którą można obronić, podczas gdy wcześniej używano po prostu trzech linijek wklejonych bez żadnej analizy.
Literatura pokrewna
- Zabezpieczanie narzędzi MCP z możliwością zapisu: siedem warstw poza tokenem — Dlaczego token MCP nie upoważnia do zapisu danych, oraz siedem warstw kontroli, oddzielenie danych uwierzytelniających, zatwierdzanie dokładnych żądań oraz zasady ponawiania prób, które to umożliwiają.
- Praktyczne wskazówki: Microsoft stworzył serwer MCP Playwright. Następnie kazał wam to zrobić — Szczegółowy przewodnik po praktycznych wskazówkach: Microsoft stworzył serwer MCP Playwright. Następnie kazał wam to zrobić: kontrakty, sprawdzania oraz gotowe elementy kodu dostępne dla zespołów wdrażających ten wzorzec.