wishlist-mcp
wishlist-mcp
Der gehostete MCP-Server für wishlist.fit. Er ermöglicht Claude, ChatGPT oder Codex, deine Wunschliste in deinem Namen zu lesen und zu aktualisieren.
https://mcp.wishlist.fit/mcpVerbinde ihn über app.wishlist.fit/connect, wo es setupschritte pro Client gibt. Du brauchst zuerst ein Wunschlisten-Konto; dieser Server erstellt nie eines.
docs/connecting.md enthält die ausführlichere Version: genaue Befehle für jeden Client, was tatsächlich gegen die Produktion verifiziert wurde, und die zwei Codex-Flags, die einen Nachmittag verschwenden, wenn man sie falsch setzt.
Was es ist
Ein reiner OAuth-2.1-Ressourcenserver vor der Wunschlisten-REST-API. Er hält keine Datenbank und keine Geschäftsregeln. Sichtbarkeit, Ratenlimits und Einladungsverwaltung leben alle in der Wunschlisten-API, und dieser Server erbt sie, indem er diese API mit dem eigenen Zugriffstoken des Benutzers aufruft.
Dieser Split ist beabsichtigt. Die Alternative – ein zweiter Dienst mit einer eigenen Kopie der Regeln – ist der Weg, wie zwei Oberflächen leise anfangen, sich darüber zu streiten, wer was sehen darf.
Claude / ChatGPT / Codex
│ MCP over HTTP, bearer token
▼
this server ──── verifies the token (issuer + audience)
│
│ the same token, forwarded
▼
api.wishlist.fit ──── applies visibility, rate limits, invite rules
│
▼
PostgresWorkOS AuthKit ist der Autorisierungsserver. Dieser Server gibt nichts aus und zeigt keinen Zustimmungsbildschirm; er verifiziert nur, was AuthKit signiert hat.
Related MCP server: Personal Toolkit MCP Server
Die Werkzeuge
Vierzehn, eines für jede Sache, die du bereits von Hand in der Web-App tun kannst. Parität ist die Regel: keine Agenten-Privilegien und nichts, was die App selbst nicht kann.
Werkzeug | Art |
| lesen |
| lesen |
| lesen |
| lesen |
| lesen |
| lesen |
| lesen |
| lesen |
| schreiben |
| schreiben |
| schreiben |
| schreiben |
| destruktiv |
| destruktiv |
wishlist_get_gift_guide gibt das Profil und die Wunschliste einer Person zusammen zurück. Es ist der Grund, warum jemand diesen Server verbindet, und ohne ihn kostet die Reise des Schenkenden drei Roundtrips.
Die zwei destruktiven Werkzeuge tragen destructiveHint: true, sodass Clients, die irreversible Aktionen bestätigen, zuerst fragen. Das Senden einer Einladung sendet einer echten Person eine E-Mail und kann nicht rückgängig gemacht werden. Eine anzunehmen ist reziprok: Der Einladende erhält Zugriff auf deine nur-für-Kreis-Felder, so wie du Zugriff auf seine erhältst.
Eine Verbindung, alles
Es gibt keine Scopes. WorkOS kann keine benutzerdefinierten ausdrücken, also trägt eine Verbindung die gesamte Werkzeugoberfläche. Schutz bei Schreibvorgängen ist verhaltensbasiert und nicht strukturell: die obigen Annotationen, die Werkzeugbeschreibungen und die Ratenlimits, die die API anwendet.
Lokal ausführen
uv sync
cp .env.example .env # point it at a local API and the Local WorkOS environment
uv run python -m wishlist_mcp.mainuv run pytest
uv run ruff format --check . && uv run ruff check .Tests stubben die Wunschlisten-API mit respx. Was sie prüfen, ist die eigene Aufgabe dieses Servers: Token verifizieren, Anfragen formen und API-Fehler in Sätze verwandeln, auf die ein Modell reagieren kann. Die Regeln selbst gehören zur API und werden dort getestet.
Konfiguration
Jede Variable hat das Präfix WISHLIST_MCP_. Siehe .env.example.
Variable | Zweck |
| Die aufzurufende Wunschlisten-REST-API |
| WorkOS-AuthKit-Aussteller. Leer bedeutet, der Server startet nicht |
| Kanonische URI. Die Zielgruppe jedes Tokens muss genau übereinstimmen |
| Der Server antwortet mit 404 auf jeden anderen Host |
| Sekunden, die auf die API gewartet wird |
RESOURCE_URI muss mit dem in WorkOS konfigurierten Ressourcenindikator Zeichen für Zeichen übereinstimmen, einschließlich des /mcp-Pfads. Eine Abweichung ist der häufigste Grund, warum ein Client die Verbindung verweigert.
Dinge, die du wissen solltest, bevor du das änderst
Jede davon ist ein Fehler, der einmal die Produktion erreicht hat.
get_http_headers()entferntauthorization. Frage explizit danach. Ohne das meldet jeder Tool-Aufruf „kein Zugriffstoken“, währendinitializeundtools/listweiterhin erfolgreich sind, weil diese beantwortet werden, bevor ein Tool-Body läuft. Ein grüner Handshake ist kein Beweis dafür, dass die Tools funktionieren.Die MCP-App ist am Root gemountet und besitzt ihren eigenen Pfad. Wenn du sie unter
/mcpmountest, leitet Starlette/mcpauf/mcp/um, und die Adresse, die jedem Client gegeben wird, hat keinen abschließenden Schrägstrich.X-Forwarded-Protowird vertraut. Cloud Run beendet TLS, also ohne es behauptet jede generierte URLhttp://. In Kombination mit der obigen Umleitung bedeutete das einmal, dass ein Client sein Bearer-Token im Klartext gesendet hätte.FastMCPs Lebenszyklus ist in den der App verkettet. Das Mounten einer ASGI-App startet ihren Lebenszyklus nicht, und ohne ihn schlägt jeder Tool-Aufruf mit „Task group ist nicht initialisiert“ fehl, während Unit-Tests weiterhin bestehen.
TestClientfolgt standardmäßig Umleitungen. Übergibfollow_redirects=False, wenn es darum geht, dass ein Pfad direkt antwortet.FastMCP matcht
Acceptper Teilstring. Es antwortet mit406 Client must accept application/jsonauf einen Client, der*/*sendet, was es bereits tut, und auf einen, der gar keinen Header sendet, was laut RFC 9110 ebenfalls der Fall ist.WildcardAcceptbuchstabiert diese aus, bevor FastMCP sie sieht. Einfachescurlsendet*/*, also war das das Erste, worauf jemand stieß.
Bereitstellung
Cloud Run, asia-southeast1, im selben Projekt wie der Rest von wishlist. main wird bei Push bereitgestellt. Die Infrastruktur lebt in wishlist-infrastructure.
Lizenz
MIT. Siehe LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
Cloud-hosted MCP server for durable AI memory
Hosted MCP server to manage a restaurant menu from AI agents - 39 tools over the DuckHub API.
Hosted Web Crawler MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
FlicenseAqualityDmaintenanceMCP server for the forme.gifts wishlist app that enables managing wishlists and gifts from Claude Code, Claude Desktop, Cursor, and other MCP clients.1015 npm-- FlicenseNot gradedqualityDmaintenanceA local MCP server providing text utilities, math functions, and a persistent todo list, enabling task automation via natural language in Claude Desktop.-
- FlicenseNot gradedqualityDmaintenanceA custom MCP server that turns Claude into an agentic shopping assistant for searching products, comparing options, managing a cart, and checking out with built-in guardrails for safe autonomous commerce.-
- AlicenseNot gradedqualityDmaintenanceA production-ready MCP server that gives an LLM agent standalone-equivalent control over a Mineflayer Minecraft bot — movement, mining, crafting, inventory, combat, containers, chat, and much more — exposed as 110 strongly-typed tools across 23 groups, with full bot lifecycle management and dual (poll + push) event streaming.159 npm10MIT