Sieben Fragen, die man stellen sollte, bevor man einen lokalen MCP-Server betreibt
Eine Checkliste für das Sandboxen lokaler MCP-Server, erprobt auf dem GitHub-Server: kurzlebige Token, abgeschlossene Netzwerkverbindung, Ausgangs-Allowlist sowie feste Tool-Listen.
Quellen: the seven questions i ask before running a local mcp server — part 2
Die Installation eines lokalen MCP-Servers bedeutet in der Regel das Einfügen eines Snippets in eine Konfigurationsdatei:
{
"mcpServers": {
"some-tool": { "command": "npx", "args": ["-y", "some-mcp-server"] }
}
}
Das sind drei Zeilen – ohne Bewertung, ohne Berechtigungsdialog und ohne Installationsschritt, an den jemand wirklich denkt. Es lohnt sich, innezuhalten und zu betrachten, was diese Zeilen bewirken. Ein lokaler MCP-Server ist kein Dienst. Er hat weder eine Port-Nummer noch ein Anmeldesystem und keine Grenzen. Es handelt sich um ein Programm, das der Agent startet und das im Namen des aktuellen Benutzers läuft, mit Zugriff auf die Dateien und das Umfeld dieses Benutzers. Die vom Agenten angezeigten Berechtigungsfragen zeigen, was der Agent tut, während das Programm hinter einer Tool-Aufruf bereits volle Kontrolle über den Rechner hat.
Eine bessere Gewohnheit ist es, vor der Installation sieben Fragen zu stellen und die Antworten zur Festlegung der Konfiguration zu nutzen.
Die sieben Fragen
- Läuft es lokal? Remote MCP-Server befinden sich auf den Maschinen Dritter und können nicht eingeschränkt werden, wodurch die übrigen Punkte der Liste bedeutungslos werden. Manchmal handelt es sich dabei um eine Entscheidung statt um eine feststehende Eigenschaft, und eine sorgfältige Wahl zwischen Remote- und Lokalbetrieb kann dazu führen, dass die anderen sechs Fragen überflüssig werden.
- Braucht es Anmeldeinformationen? Entweder gar keine oder eine spezifische, die genannt werden kann.
- An welchen Ort stellt es eine Verbindung her? Entweder zu einer kurzen, festgelegten Liste von Hosts oder zu beliebigen URLs.
- Welche Dateien benötigt es? Einen Arbeitsbereich, alles oder gar nichts.
- Braucht es noch etwas anderes vom Host? Eine Desktop-Sitzung, einen Socket, einen Browser.
- Läuft es Code aus, den es herunterlädt? Falls ja, muss dieser Code gesichert werden.
Die Fragen eins bis sechs lassen sich aus der eigenen Dokumentation des Servers in etwa zehn Minuten beantworten, ohne in externe Quellen suchen zu müssen. Nur die siebte Frage hat eine konkrete Messung: Nach der Installation reicht ein einziger Aufruf von tools/list aus, wobei die Anzahl der Tools in der Regel die Erwartungen übertrifft.
Beispiellösung: Der GitHub-Server
| Frage | Antwort für den GitHub-Server |
|---|---|
| Läuft lokal? | Ja, und er wird bereits als Containerbild bereitgestellt |
| Anmeldeinformationen | Notwendig, da private Repositorien nicht anonym gelesen werden können |
| Verbindet sich mit | Einem einzigen Host, api.github.com |
| Dateien | Nichts außer dem Schlüssel. Die Arbeit erfolgt über die API, daher existiert weder ein Clone noch ein Checkout auf der Festplatte |
| Weitere Anforderungen am Host | Nichts |
| Code wird zur Laufzeit heruntergeladen | Nein |
| Tool-Liste | Kann über --toolsets und --exclude-tools reduziert werden |
Insgesamt geben die Antworten die Konfiguration an: ein Zugangsdatensatz, kein montierter Ordner, ein einziger Zielort sowie eine Tool-Liste, die reduziert werden sollte.
Der Zugangsdatensatz stellt das schwierigere Element dar, da er aus dem Design nicht entfernt werden kann. Wenn ein Agent Pull-Requests öffnet, muss er Schreibzugriff haben. Stattdessen werden Schutzmaßnahmen angewandt, die damit beginnen, stattdessen eine GitHub App statt eines persönlichen Zugangstokens zu verwenden:
{
"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"
]
}
}
}
Die Schichten um dieses Zertifikat
- Kurzlebige Tokens. Eine GitHub App erzeugt Tokens, die schnell ablaufen.
- Nur-Lese-Montagen. Der Signierungs Schlüssel wird nur zum Lesen montiert und gehört dem UID, auf den der Container verknüpft ist, und nicht dem Benutzer. Er befindet sich nicht in
~/.ssh, wo er weder ein SSH-Schlüssel noch weiterhin vom Benutzer lesbar wäre. - Unbefugte Container. Der Docker-Daemon läuft im rootlosen Modus, der Prozess verwendet einen nicht-root-Benutzer und es werden keine Berechtigungen gewährt.
- Ein Repository, vier Berechtigungen.
contents,issuesundpull_requestserhalten Schreibrechte,metadataLeserechte, und jeder erzeugte Token enthält genau diese Rechte. - Eine abgeschlossene Netzwerkstruktur. Es gibt keinen direkten Ausgang, daher ist ein Proxy der einzige Weg.
- Eine Ausgangs-Allowlist. Alles, was innerhalb des Containers erstellt wird, kann nur an
api.github.comgesendet werden. - Angesehene Toolsets und anschließend ausgeschlossene Tools.
--toolsetsblockiert ganze Gruppen, während--exclude-toolsalles entfernt, was in den behaltenen Gruppen übrig bleibt.
Den letzten beiden Punkten wird wenig Aufmerksamkeit geschenkt. Die Einschränkung der Tool-Liste stellt das niedrigste Berechtigungslevel dar, das dennoch einen Schreibzugriff ermöglicht. Die Allowlist schützt nicht nur lokale Dateien, da sie außerdem einschränkt, wo gestohlene Anmeldeinformationen verwendet werden können.
Diese Behauptung erfordert eine Messung. Mit --toolsets context,issues,pull_requests,repos stellt der Server 42 Tools zur Verfügung. Fünf davon können mit diesen Berechtigungen nicht verwendet werden. Nach dem Einsatz von --exclude-tools bleiben 37 übrig, von denen 15 schreiben können. Da --toolsets ganze Gruppen auswählt, werden auch create_repository und fork_repository mitgeliefert – unabhängig davon, ob der Token sie nutzen kann oder nicht. 37 ist keine kleine Zahl, aber sie ist ehrlich und zeigt, wie es aussieht, wenn ein Agent tatsächlich einen Branch pushen muss.
Warum die Allowlist kein Übermaß ist
Zu Beginn scheint die Allowlist übertrieben zu sein, bis man sich fragt, was sie verhindert. Niemand kann den Container dazu bringen, attacker.com zu kontaktieren, sodass ein dort erstelltes Token keinen feindlichen Ort ansteuern kann. Das Proxy-Log protokolliert für jeden Versuch beide Ergebnisse:
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/-
Die Flagge -e HTTPS_PROXY sorgt nicht dafür. Linux verfügt weder über eine eingebaute Vorstellung von einem Proxy noch über einen Kernel-Switch oder einen libc-Hook. Die Variable ist lediglich Text im Umgebungsvariablen-System, und jeder HTTP-Client entscheidet selbst, ob er sie berücksichtigt. Go’s net/http berücksichtigt sie, weshalb dieser spezielle Server keine zusätzlichen Maßnahmen benötigt. Node’s eingebautes fetch tut dies hingegen nicht, was bedeutet, dass ein Node-Server die Einstellung völlig ignoriert. Der Schutzmechanismus besteht in der Netzwerkkonfiguration: Ohne Ausgangsroute verbindet sich ein Client, der die Variable ignoriert, nicht direkt, sondern gibt einfach einen Fehler an. In einem Netzwerk mit einer Route würde derselbe Fehler dazu führen, dass Daten ohne Warnung durchsickern.
Überprüfung gegenüber der OWASP MCP Top 10
Die Zuordnung dieser Konfiguration zu den OWASP MCP Top 10 kennzeichnet jedes Risiko als behoben, verbleibend und verwaltet, unberücksichtigt oder nicht auf einen lokalen stdio-Server anwendbar, wobei Anmerkungen zu den weiterhin offenen Punkten gegeben werden.
Was ist noch außerhalb des Umfangs
Keine Sandbox ist jemals vollständig. Drei Themen liegen völlig außerhalb dieser Konfiguration: entfernte MCP-Server, Server, die beliebige URLs abrufen, sowie das Modell selbst.
Ab diesem Punkt handelt es sich nicht mehr um eine vergessene Einstellung. Alle diese Kontrollmechanismen gelten pro Container, müssen manuell eingetragen werden und müssen für jeden hinzugefügten Server dupliziert werden. Drei Server benötigen drei Allowlists sowie drei Toolset-Strings, und kein Komponente überwacht die gesamte Sitzung.
Fehlt ist ein Gateway, das zwischen dem Agenten und seinen Servern platziert wird. Ein Gateway kann ein Tool vollständig aus list_tools entfernen und jeden Aufruf erneut überprüfen, bevor er weitergeleitet wird, sodass die Tool-Liste pro Sitzung angepasst wird und nicht pro Konfigurationsdatei. Es kann dennoch das Verhalten eines laufenden Servers nicht beobachten: geöffnete Dateien, kontaktierte Hosts, gelesene Anmeldeinformationen. Ein kompromittierter Server benötigt keinen Tool-Aufruf, um Schlüssel an einen anderen Ort zu senden. Ein Gateway fügt eine weitere Schicht hinzu, ohne die vorhandenen Schichten zu entfernen.
Regeln, die auf jeden lokalen Server zutreffen
Die oben genannten Antworten gehören zu GitHub. Die daraus resultierenden Regeln gelten für jeden lokalen Server, der in eine Konfiguration eingefügt werden soll:
- Wählen Sie Anmeldeinformationen, die ablaufen. Eine GitHub App ist besser als ein persönlicher Zugriffstoken. Der Container speichert einen Signierungsschlüssel und erstellt für jeden Gebrauch einen neuen Token, wodurch dieser von selbst ungültig wird, anstatt darauf gewartet werden zu müssen, dass jemand ihn widerruft.
- Beschränken Sie die Berechtigungen auf den erforderlichen Umfang, nicht nur die Anmeldeinformationen. Ein Repository mit vier Berechtigungen – jeder Token enthält genau diese.
- Sichern Sie das Netzwerk ab. Da es keine voreingestellten Umleitungen gibt, kann der Server die Proxy-Einstellung nicht ablehnen, während
-e HTTPS_PROXYlediglich eine Anfrage darstellt. - Führen Sie eine Allowlist für Zieladressen ein. Ein Host,
api.github.com. Anmeldeinformationen, die aus diesem Container gestohlen werden, können nicht anderswo verwendet werden, und jeder Versuch wird in jedem Fall im Protokoll erfasst.
--user 10001 aus, entziehen Sie mit --cap-drop ALL die Berechtigungen und fügen Sie --security-opt no-new-privileges hinzu. Montieren Sie außerdem das Dateisystem --read-only und verwenden Sie dazu einen tmpfs für temporäre Dateien./key.pem:ro, und geben Sie kein Arbeitsverzeichnis. Das Binden von $HOME in einen Container zählt nicht als Sandboxing.--toolsets werden bestimmte Gruppen ausgeschlossen, und --exclude-tools reduziert die verbleibenden Tools. Dadurch sinkt die Anzahl der Tools auf diesem Server von 42 auf 37, wobei 15 davon weiterhin schreiben können.latest sowie Versionsbezeichnungen, da diese geändert werden können. Beide Bilder in dieser Konfiguration, einschließlich des Proxys, verwenden @sha256:…, sodass sie nicht verändert werden können.Es gibt keine einzige Regel, die festlegt, ob Schäden entstehen. Ein vergiftetes Dokument kann den Agenten dennoch dazu bringen, eine Tool-Aufruf zu tätigen. Jede Regel beschränkt, wie weit sich eine Auswirkung ausbreiten kann, und keine Regel schließt den Auslöser vollständig aus. Eine Sandbox regelt, wo ein Programm sprechen darf, niemals, was es sagt.
Die Allowlist zeigt die Grenze auf. Sie überprüft, ob der Verkehr an api.github.com gerichtet ist, gibt aber keine Informationen über den Inhalt preis. contents: write erlaubt dem Agenten, einen Branch zu erstellen, und ermöglicht gleichzeitig, dass eine eingegebene Anweisung eine Datei commitet. Branchnamen, Commit-Nachrichten und Issue-Überschriften erscheinen einzeln in Ordnung, doch in Kombination können sie alles Mögliche in ein Repository einschmuggeln, das andere lesen können. Jeder Filter, der ausreichend permissiv ist, damit der Agent arbeiten kann, lässt Daten heraus, denn die eigentliche Arbeit besteht darin, auf GitHub zu lesen und zu schreiben.
Betrachten Sie daher all das als Ausgangspunkt und nicht als Ziel, und legen Sie es zuerst fest. Der Preis sind sieben Fragen, etwa zehn Minuten Lesenzeit und ein einziger Aufruf von tools/list. Im Gegenzug erhalten Sie eine Konfiguration, die verteidigt werden kann, während zuvor drei Zeilen blind eingefügt wurden.
Weitere Literatur
- Sicherung von MCP-Tools mit Schreibfunktion: Sieben Schutzschichten jenseits des Tokens — Warum ein MCP-Token keine Schreibvorgänge autorisiert und welche sieben Kontrollschichten, Trennung von Zugangsdaten, Genehmigung genauer Anfragen sowie Wiederholungsregeln dies möglich machen.
- Praktische Hinweise: Microsoft entwickelte den Playwright MCP Server – und sagte Ihnen dann, was Sie tun sollen — Detaillierte Anleitung zu den Praktischen Hinweisen: Microsoft entwickelte den Playwright MCP Server – und sagte Ihnen dann, was Sie tun sollen: Verträge, Überprüfungen sowie Code-Blöcke, die Teams nutzen können, die dieses Muster implementieren.