Skip to main content
Glama
wishlist-mcp

wishlist-mcp

by teslakoile

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/mcp

Verbinde 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
        │
        ▼
     Postgres

WorkOS 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

wishlist_search_people

lesen

wishlist_get_gift_guide

lesen

wishlist_get_profile

lesen

wishlist_get_wishlist

lesen

wishlist_get_my_profile

lesen

wishlist_get_my_wishlist

lesen

wishlist_list_circle

lesen

wishlist_preview_invite

lesen

wishlist_add_item

schreiben

wishlist_update_item

schreiben

wishlist_update_my_profile

schreiben

wishlist_accept_invite

schreiben

wishlist_create_invite

destruktiv

wishlist_delete_item

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.main
uv 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

API_BASE_URL

Die aufzurufende Wunschlisten-REST-API

AUTHKIT_DOMAIN

WorkOS-AuthKit-Aussteller. Leer bedeutet, der Server startet nicht

RESOURCE_URI

Kanonische URI. Die Zielgruppe jedes Tokens muss genau übereinstimmen

HOST

Der Server antwortet mit 404 auf jeden anderen Host

API_TIMEOUT

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() entfernt authorization. Frage explizit danach. Ohne das meldet jeder Tool-Aufruf „kein Zugriffstoken“, während initialize und tools/list weiterhin 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 /mcp mountest, leitet Starlette /mcp auf /mcp/ um, und die Adresse, die jedem Client gegeben wird, hat keinen abschließenden Schrägstrich.

  • X-Forwarded-Proto wird vertraut. Cloud Run beendet TLS, also ohne es behauptet jede generierte URL http://. 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.

  • TestClient folgt standardmäßig Umleitungen. Übergib follow_redirects=False, wenn es darum geht, dass ein Pfad direkt antwortet.

  • FastMCP matcht Accept per Teilstring. Es antwortet mit 406 Client must accept application/json auf einen Client, der */* sendet, was es bereits tut, und auf einen, der gar keinen Header sendet, was laut RFC 9110 ebenfalls der Fall ist. WildcardAccept buchstabiert diese aus, bevor FastMCP sie sieht. Einfaches curl sendet */*, 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

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      MCP server for the forme.gifts wishlist app that enables managing wishlists and gifts from Claude Code, Claude Desktop, Cursor, and other MCP clients.
      10
      15 npm
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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 npm
      10
      MIT