Skip to main content
Glama
wishlist-mcp

wishlist-mcp

by teslakoile

wishlist-mcp

これは wishlist.fit 用のホスト型 MCP サーバーです。Claude、ChatGPT、Codex があなたの代わりにウィッシュリストを読み取り・更新できるようにします。

https://mcp.wishlist.fit/mcp

app.wishlist.fit/connect から接続します。そこにはクライアントごとのセットアップ手順があります。まずウィッシュリストのアカウントが必要です。このサーバーがアカウントを作成することはありません。

docs/connecting.md には詳細版があります。各クライアントの正確なコマンド、本番環境で実際に検証された内容、そして間違えると午後を無駄にする 2 つの Codex フラグについて説明しています。

これは何か

これは wishlist REST API の前に立つ純粋な OAuth 2.1 リソースサーバーです。データベースもビジネスルールも持ちません。可視性、レート制限、招待処理はすべて wishlist API にあり、このサーバーはユーザー自身のアクセストークンでその API を呼び出すことでそれらを継承します。

この分割は意図的です。別の方法として、ルールの独自コピーを持つ第 2 のサービスを立てると、誰が何を見られるかについて 2 つの表面が静かに食い違い始めることになります。

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 が認可サーバーです。このサーバーは何も発行せず、同意画面も表示しません。AuthKit が署名したものを検証するだけです。

Related MCP server: Personal Toolkit MCP Server

ツール

14 個あり、Web アプリで手動でできることそれぞれに対応しています。パリティが原則です。エージェント専用の特権はなく、アプリ自体ができないこともありません。

ツール

種類

wishlist_search_people

読み取り

wishlist_get_gift_guide

読み取り

wishlist_get_profile

読み取り

wishlist_get_wishlist

読み取り

wishlist_get_my_profile

読み取り

wishlist_get_my_wishlist

読み取り

wishlist_list_circle

読み取り

wishlist_preview_invite

読み取り

wishlist_add_item

書き込み

wishlist_update_item

書き込み

wishlist_update_my_profile

書き込み

wishlist_accept_invite

書き込み

wishlist_create_invite

破壊的

wishlist_delete_item

破壊的

wishlist_get_gift_guide は、人物のプロフィールとウィッシュリストをまとめて返します。これが誰もがこのサーバーに接続する理由であり、これがないと贈り主の旅は 3 往復かかります。

2 つの破壊的ツールには destructiveHint: true が付いているため、元に戻せない操作を確認するクライアントは最初に確認を求めます。招待を送信すると実際の人物にメールが届き、送信を取り消すことはできません。招待を受け入れることは相互的です。招待者はあなたのサークル限定フィールドにアクセスできるようになり、あなたも招待者のサークル限定フィールドにアクセスできるようになります。

1 つの接続で全て

スコープはありません。WorkOS はカスタムスコープを表現できないため、接続はツール全体の表面を運びます。書き込みの保護は構造的ではなく行動的です。上記の注釈、ツールの説明、API が適用するレート制限です。

ローカルでの実行

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 .

テストは respx で wishlist API をスタブ化します。テストが確認するのはこのサーバー自身の仕事、つまりトークンの検証、リクエストの整形、API エラーをモデルが対応できる文に変換することです。ルール自体は API に属し、そこでテストされます。

設定

すべての変数は WISHLIST_MCP_ というプレフィックスが付いています。.env.example を参照してください。

変数

用途

API_BASE_URL

呼び出す wishlist REST API

AUTHKIT_DOMAIN

WorkOS AuthKit の発行者。空の場合、サーバーは起動を拒否します

RESOURCE_URI

正規 URI。すべてのトークンの audience はこれと完全に一致する必要があります

HOST

サーバーは他のホストでは 404 を返します

API_TIMEOUT

API を待機する秒数

RESOURCE_URI は WorkOS で設定されたリソースインジケーターと 1 文字単位で 一致する必要があります。/mcp パスも含みます。不一致はクライアントが接続を拒否する最も一般的な理由です。

これを変更する前に知っておくべきこと

これらはそれぞれ、かつて本番環境に到達したバグです。

  • get_http_headers() は authorization を削除します。 明示的に要求してください。そうしないと、initialize と tools/list は成功する一方で、すべてのツール呼び出しが「アクセストークンがありません」と報告します。なぜなら、それらはツール本体が実行される前に応答されるからです。ハンドシェイクが成功しても、ツールが動作する証拠にはなりません。

  • MCP アプリはルートにマウントされ、独自のパスを持ちます。 /mcp にマウントすると、Starlette は /mcp を /mcp/ にリダイレクトし、すべてのクライアントに渡されるアドレスには末尾のスラッシュがありません。

  • X-Forwarded-Proto は信頼されます。 Cloud Run は TLS を終了するため、これがないと生成されるすべての URL が http:// を主張します。上記のリダイレクトと組み合わさると、かつてクライアントがベアラートークンを平文で送信する可能性がありました。

  • FastMCP のライフスパンはアプリのライフスパンにチェーンされています。 ASGI アプリをマウントしてもそのライフスパンは開始されず、これがないとすべてのツール呼び出しが「タスクグループが初期化されていません」で失敗する一方、単体テストはまだ成功します。

  • TestClient はデフォルトでリダイレクトに従います。 パスが直接応答することを確認したい場合は follow_redirects=False を渡してください。

  • FastMCP は Accept を部分文字列で照合します。 */* を送信するクライアント(すでに受け入れている)と、ヘッダーをまったく送信しないクライアント(RFC 9110 ではこれも受け入れている)に対して、406 Client must accept application/json と応答します。WildcardAccept は FastMCP がそれらを見る前にそれらを明示します。素の curl は */* を送信するため、これが最初に誰もが遭遇する問題でした。

デプロイ

Cloud Run、asia-southeast1、wishlist の他の部分と同じプロジェクトにあります。main はプッシュ時にデプロイされます。インフラストラクチャは wishlist-infrastructure にあります。

ライセンス

MIT。 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