wishlist-mcp
wishlist-mcp
これは wishlist.fit 用のホスト型 MCP サーバーです。Claude、ChatGPT、Codex があなたの代わりにウィッシュリストを読み取り・更新できるようにします。
https://mcp.wishlist.fit/mcpapp.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
│
▼
PostgresWorkOS AuthKit が認可サーバーです。このサーバーは何も発行せず、同意画面も表示しません。AuthKit が署名したものを検証するだけです。
Related MCP server: Personal Toolkit MCP Server
ツール
14 個あり、Web アプリで手動でできることそれぞれに対応しています。パリティが原則です。エージェント専用の特権はなく、アプリ自体ができないこともありません。
ツール | 種類 |
| 読み取り |
| 読み取り |
| 読み取り |
| 読み取り |
| 読み取り |
| 読み取り |
| 読み取り |
| 読み取り |
| 書き込み |
| 書き込み |
| 書き込み |
| 書き込み |
| 破壊的 |
| 破壊的 |
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.mainuv run pytest
uv run ruff format --check . && uv run ruff check .テストは respx で wishlist API をスタブ化します。テストが確認するのはこのサーバー自身の仕事、つまりトークンの検証、リクエストの整形、API エラーをモデルが対応できる文に変換することです。ルール自体は API に属し、そこでテストされます。
設定
すべての変数は WISHLIST_MCP_ というプレフィックスが付いています。.env.example を参照してください。
変数 | 用途 |
| 呼び出す wishlist REST API |
| WorkOS AuthKit の発行者。空の場合、サーバーは起動を拒否します |
| 正規 URI。すべてのトークンの audience はこれと完全に一致する必要があります |
| サーバーは他のホストでは 404 を返します |
| 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…
This server cannot be deployed
Maintenance
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