Puter MCP
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
Läuft in der Cloud✓ vom Dienst · puter.com
Surfbird MCP
What it does
Self-hosted Kitesurf headless browser: markdown, screenshots, PDF, evaluate, batch.
- Connects Läuft auf deinem Computer
- Account or key Needs SURFBIRD_TOKEN
- Category Dokumente, Tabellen & Büroarbeit
Installation
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 14. Nov. 2026
Zuerst: Welche KI nutzt du?
Wähle deine App, dann erscheinen die Schritte unten.
Node.js installieren
Nur einmal; gilt für alle Server, die Node.js brauchen
Bei Surfbird MCP registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Einstellungsdatei der Claude-Desktop-App öffnen
SettingsDeveloperEdit Config
Diese Einstellungen einfügen und speichern
{ "mcpServers": { "surfbird": { "command": "npx", "args": [ "-y", "surfbird-mcp" ], "env": { "SURFBIRD_TOKEN": "your-value" } } } }Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Claude beenden und neu öffnen
Ausprobieren
Nutze Surfbird MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude sagt, dass es Surfbird MCP nutzt, oder ein Werkzeug von Surfbird MCP in der Antwort zeigt, bist du verbunden
2 optionale Einstellung(en) (geht auch ohne)
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
SURFBIRD_URLBase URL of the Surfbird auth-image REST proxy · Standard http://127.0.0.1:8080SURFBIRD_TIMEOUT_MSPer-tool timeout in milliseconds · Standard 120000
Die Beschreibungen sind noch im englischen Original.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
ChatGPT kann Surfbird MCP noch nicht verbinden
Surfbird MCP läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen
Das kannst du stattdessen tun
A · Eine App nutzen, die Surfbird MCP verbinden kann
- Du brauchst einen Schlüssel von Surfbird MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
- Du brauchst einen Schlüssel von Surfbird MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
- Du brauchst einen Schlüssel von Surfbird MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
- Du brauchst einen Schlüssel von Surfbird MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Klappt mit Claude Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Surfbird MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Node.js installieren
Nur einmal; gilt für alle Server, die Node.js brauchen
Bei Surfbird MCP registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Terminal öffnen
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
Diesen Befehl einfügen und Enter drücken
claude mcp add --scope user surfbird --env SURFBIRD_TOKEN=your-value -- npx -y surfbird-mcpErsetze „your-value“ vor dem Enter durch deinen Schlüssel
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
/mcp in Claude Code eingeben
Surfbird MCP sollte in der Liste als verbunden erscheinen
Ausprobieren
Nutze Surfbird MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude Code sagt, dass es Surfbird MCP nutzt, oder ein Werkzeug von Surfbird MCP in der Antwort zeigt, bist du verbunden
2 optionale Einstellung(en) (geht auch ohne)
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
SURFBIRD_URLBase URL of the Surfbird auth-image REST proxy · Standard http://127.0.0.1:8080SURFBIRD_TIMEOUT_MSPer-tool timeout in milliseconds · Standard 120000
Die Beschreibungen sind noch im englischen Original.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Cursor, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Surfbird MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Node.js installieren
Nur einmal; gilt für alle Server, die Node.js brauchen
Bei Surfbird MCP registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Schlüssel eintragen
In den Einstellungen von Surfbird MCP ist SURFBIRD_TOKEN leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
KI-Chat in Cursor im Agent-Modus öffnen
Ausprobieren
Nutze Surfbird MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Cursor sagt, dass es Surfbird MCP nutzt, oder ein Werkzeug von Surfbird MCP in der Antwort zeigt, bist du verbunden
2 optionale Einstellung(en) (geht auch ohne)
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
SURFBIRD_URLBase URL of the Surfbird auth-image REST proxy · Standard http://127.0.0.1:8080SURFBIRD_TIMEOUT_MSPer-tool timeout in milliseconds · Standard 120000
Die Beschreibungen sind noch im englischen Original.
Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit VS Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Surfbird MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Node.js installieren
Nur einmal; gilt für alle Server, die Node.js brauchen
Bei Surfbird MCP registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Mit diesem Button VS Code öffnen
VS Code fragt nach einer Bestätigung; klicke Install
Schlüssel eintragen
In den Einstellungen von Surfbird MCP ist SURFBIRD_TOKEN leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
KI-Chat in VS Code im Agent-Modus öffnen
Ausprobieren
Nutze Surfbird MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn VS Code sagt, dass es Surfbird MCP nutzt, oder ein Werkzeug von Surfbird MCP in der Antwort zeigt, bist du verbunden
2 optionale Einstellung(en) (geht auch ohne)
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
SURFBIRD_URLBase URL of the Surfbird auth-image REST proxy · Standard http://127.0.0.1:8080SURFBIRD_TIMEOUT_MSPer-tool timeout in milliseconds · Standard 120000
Die Beschreibungen sind noch im englischen Original.
Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach
JSON-Einstellungen stehen unten unter „Für Entwickler“
Für Entwickler: Terminal-Befehle und JSON-Einstellungen
Auf deinem Computer installiert
Claude Code
claude mcp add --scope user surfbird --env SURFBIRD_TOKEN=your-value -- npx -y surfbird-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"surfbird": {
"command": "npx",
"args": [
"-y",
"surfbird-mcp"
],
"env": {
"SURFBIRD_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"surfbird": {
"command": "npx",
"args": [
"-y",
"surfbird-mcp"
],
"env": {
"SURFBIRD_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"surfbird": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"surfbird-mcp"
],
"env": {
"SURFBIRD_TOKEN": "your-value"
}
}
}
}Werte, die du selbst einträgst
SURFBIRD_URLenvBase URL of the Surfbird auth-image REST proxySURFBIRD_TOKENgeheim erforderlich envBearer token matching SURFBIRD_TOKEN on the containerSURFBIRD_TIMEOUT_MSenvPer-tool timeout in milliseconds
Die Beschreibungen sind noch im englischen Original.
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
Auf einen Blick
Welche Apps ihn nutzen können
Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.
Laufen auf deinem Computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Was er kann
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Basischecksi
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 14. Nov. 2026
- ✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto terry2010 bestätigt, dem das Repo gehört
- ✓ Bestanden
Wird noch gepflegt
Code zuletzt geändert: heute
- ✓ Bestanden
Hat eine Lizenz
Nutzt Apache-2.0
- – Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
- – Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
- … Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Diskussion
Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Nutzerbewertungen
Noch keine Bewertungen
Im Vergleich mit anderen in Dokumente, Tabellen & Büroarbeiti
- Mehr Sterne als 81 % der anderen 3927 Server in dieser Kategorie
- Neuer in der Registry veröffentlicht als 96 % der anderen 3927 Server in dieser Kategorie
- Basischecks gleich gut wie oder besser als bei 100 % der anderen 3927 Server in dieser Kategorie
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Häufige Fragen
Ist Surfbird MCP sicher?
Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Welche Schlüssel oder Codes braucht er?
Das musst du eintragen: SURFBIRD_TOKEN
Läuft er auf meinem Computer oder in der Cloud?
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Wird er noch gepflegt?
Das GitHub-Repo wurde zuletzt heute geändert, und die neueste Version (0.1.2) kam heute in die Registry.
Welche Apps können ihn nutzen?
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.
Was kann ich stattdessen nutzen?
In derselben Kategorie: Puter MCP, XcodeBuildMCP, XcodeBuildMCP
Andere in derselben Kategorie
Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
XcodeBuildMCP
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Läuft auf deinem Computer✓ vom Dienst · xcodebuildmcp.com
XcodeBuildMCP
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Läuft auf deinem Computer
README vom Entwickler
README öffnen
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
Surfbird
Kitesurf, self-hosted. An unofficial Docker distribution of Cloudflare Kitesurf — the experimental browser engine built for AI agents.
Not affiliated with or endorsed by Cloudflare. Kitesurf is Apache-2.0 licensed.
Kitesurf parses HTML, applies CSS, runs page JavaScript and renders screenshots — no Chrome, no browser container — and speaks CDP, so Puppeteer/Playwright connect as usual. Upstream only supports wrangler dev locally or deploying to Cloudflare Workers (paid). Surfbird packages it for any VPS.
Images
| Tag | Contents | Use |
|---|---|---|
terry2010/surfbird:raw | engine only, :8787 | local / behind your own gateway |
terry2010/surfbird:auth | engine + token auth proxy + optional TLS, :8080 | one-command, exposed |
terry2010/surfbird:latest | = :auth | convenience default |
Images auto-build daily when upstream cuts a new tag; per-tag pins like terry2010/surfbird:auth-2026.11.8 are also published.
Quick start
# raw — engine only, no auth. Bind loopback/internal only!docker run -d -p 127.0.0.1:8787:8787 terry2010/surfbird:raw
auth — one command, token + REST actions
docker run -d -p 127.0.0.1:8080:8080 -e SURFBIRD_TOKEN=$(openssl rand -hex 24) terry2010/surfbird:auth
Usage
CDP (Puppeteer / Playwright / chrome-devtools-mcp):
puppeteer.connect({browserWSEndpoint: "ws:// :8787/devtools/browser", // raw // or auth image: browserWSEndpoint: "ws:// :8080/devtools/browser", headers: { Authorization: "Bearer " }, });
REST (auth image only):
curl -H "Authorization: Bearer $TOKEN" \-d '{"url":"https://zhuikan.com/repos/terry2010__surfbird","fullPage":true}' \ http:// :8080/screenshot -o page.png
curl -H "Authorization: Bearer $TOKEN" \ -d '{"url":"https://zhuikan.com/repos/terry2010__surfbird"}' \ http:// :8080/markdown | jq -r .markdown
Endpoints: POST /screenshot | /pdf | /content | /source | /markdown | /evaluate | /batch (one action over up to MAX_BATCH_URLS urls, per-item results), GET /health, GET /openapi.json. /content returns the post-JS rendered DOM; /source returns the original response body ("view source"). All other paths transparently proxy to the engine (landing page, /json/*, /rbi/*).
JS/TS client: surfbird on npm — new Surfbird(url,{token}).markdown(u) etc., plus sb.batch(action, urls).
MCP (Model Context Protocol)
Two ways to plug Surfbird into an MCP-capable agent (Claude Code, Cursor, Windsurf, …):
A. `surfbird-mcp` — thin wrapper (recommended). Exposes our REST actions as MCP tools — including surf_markdown and surf_batch, which stock browser MCPs don't have:
{"mcpServers": { "surfbird": { "command": "npx", "args": ["-y", "surfbird-mcp"], "env": { "SURFBIRD_URL": "http:// :8080", "SURFBIRD_TOKEN": " " } } } }
Tools: surf_markdown surf_content surf_source surf_screenshot surf_pdf surf_evaluate surf_batch surf_health.
B. `chrome-devtools-mcp` — full CDP surface. Points straight at the proxied WebSocket (/devtools/browser passes through with Bearer auth) — more tools, more moving parts. See upstream docs; if your client can't send custom WS headers, run a raw image on a private network instead.
No MCP at all? The REST layer is agent-friendly on its own — skills/surfbird/SKILL.md is a drop-in skill that teaches any agent to drive it with curl.
Examples
examples/ — zero-dep Python client (rss_to_markdown.py builds a feed→markdown digest for LLM daily reports) and bash/curl scripts.
Env
| Var | Default | Meaning | |
|---|---|---|---|
SURFBIRD_TOKEN | — | bearer token. auth mode refuses to start without it | |
SURFBIRD_PORT | 8080 | proxy listen port | |
TLS_CERT_PATH / TLS_KEY_PATH | — | mount certs → HTTPS. Want auto-ACME? put Caddy outside | |
REST_TIMEOUT_MS | 120000 | per-action timeout | |
MAX_CONCURRENT_ACTIONS | 2 | in-flight REST actions cap (each ≈ an engine isolate) | |
MAX_BATCH_URLS | 20 | max urls per /batch call | |
MAX_BODY_BYTES | 4194304 | REST request body cap (413 beyond) | |
SURFBIRD_INSPECTOR | — | 1 opens the workerd debug inspector on :9229 (loopback, debugging only) | |
SURFBIRD_URL_ALLOWLIST | — | comma-separated regexes — if set, only matching urls may be fetched | |
SURFBIRD_URL_BLOCKLIST | — | comma-separated regexes — refuse matching urls (e.g. `169\.254\.\ | ,^http://localhost`) |
ENGINE_READY_TIMEOUT_MS | 120000 | startup wait for engine before proxy listens | |
SURFBIRD_MODE | per target | raw / auth |
GET /health is unauthenticated and returns 200 only when the engine answers — safe for LB probes. If either process dies, the container exits; use --restart unless-stopped.
Bound to loopback above — reach a remote instance via SSH tunnel (ssh -L 8080:127.0.0.1:8080 user@vps) or a TLS reverse proxy. An exposed engine is a request-making machine on your VPS: token + firewall/TLS are the minimum, never expose raw.
Building
# A) full in-image build (needs ~4GB+ RAM, CI machines):docker build -f Dockerfile --target raw -t surfbird:raw . docker build -f Dockerfile --target auth -t surfbird:auth .
B) from a locally-built checkout (low-resource hosts):
./scripts/smoke-test.sh # stages a real ctx via tar (symlinks won't work — Docker can't COPY through them)
or manually:
mkdir -p ctx/kitesurf && tar -C /path/to/kitesurf --exclude='*/node_modules' --exclude='*/.git' -cf - . | tar -C ctx/kitesurf -xf - cp -r proxy ctx/proxy && cp entrypoint.sh Dockerfile.prebuilt ctx/ docker build -f ctx/Dockerfile.prebuilt ctx -t surfbird:raw
Pin upstream: --build-arg KITESURF_REF= (Dockerfile A). Engine patches: drop .patch files into patches/, applied after clone.
Limits (from upstream, not Surfbird's fault)
- Experimental engine (Boa JS) — heavy-JS sites may render imperfectly
- No touch/drag gestures, no video decode, no browser-style file downloads
- DevTools frontend excluded from builds (China-network-safe); use CDP
- Auth image adds a token gate — it is not a hardened multi-tenant boundary
License
Apache-2.0. Kitesurf © Cloudflare, Inc. See upstream NOTICE.