FindA.Sale

FindA.Sale MCP サーバー

FindA.Sale のセールや商品を検索するための、公開・読み取り専用の Model Context Protocol サーバーです。 公式 TypeScript MCP SDK v2（@modelcontextprotocol/server 2.3.x、MCP 仕様 2026-07-28）を基盤としています。

本番環境：https://mcp.finda.sale（Railway サービス findasale、プロジェクト keen-wisdom、ルートディレクトリ packages/mcp-server、Dockerfile.production。packages/mcp-server/** に影響する main へのプッシュで自動デプロイされます）。

エンドポイント

パス	目的
POST /mcp	ステートレスな Streamable HTTP トランスポートです。2026-07-28 のクライアントと、ステートレスフォールバックを使用する 2025 年代のクライアントに対応します。GET／DELETE は 405 を返します。
GET /sse + POST /messages?sessionId=…	@modelcontextprotocol/server-legacy/sse を使用した従来の HTTP+SSE トランスポートです（仕様では非推奨ですが、既存のクライアント向けに維持しています）。
POST /messages（sessionId なし）	v1 から維持されているセッションレス JSON-RPC shim です。initialize、ping、tools/list、tools/call に対応します。
GET /mcp/server-card	MCP Server Card（application/mcp-server-card+json）です。エイリアス：/.well-known/mcp/server-card.json。
GET /.well-known/ai-catalog.json	Server Card にリンクする AI Catalog です。
GET /.well-known/mcp.json	非公式マニフェストです（finda.sale/.well-known/mcp.json にも複製されています）。
GET /health	Railway のヘルスチェックです。

ツール

10 個のツールはすべて読み取り専用です（readOnlyHint: true、destructiveHint: false、idempotentHint: true）。 スキーマは各ツールの隣にある src/tools/*.ts（zod v4）に、ハンドラーは src/handlers.ts にあります。

search_sales、get_sale、search_items、get_item、list_cities、list_sale_types、 list_categories、get_trending_sales、get_sales_starting_soon、find_item_for_sale。

プライバシーと安全性のルール

• バックエンドは常に匿名で呼び出されます（認証ヘッダーは送信も転送もされません）。そのため、公開閲覧者向けのルールが適用されます。DRAFT／CANCELLED／削除済みのセールは 404 になり、先行アクセス対象および Legendary の商品は公開保留のままとなり、番地は非公開です。
• すべてのレスポンスは src/lib/publicShape.ts の許可リストに基づいて再構築されます。番地、入口の暗証番号、道順メモ、主催者の電話番号／住所／ユーザー ID、決済処理業者の ID、スクレイピングメタデータは返されません。座標は小数点以下 2 桁に丸められます（約 1 km）。
• バックエンドのエラーは、簡潔で一般的なメッセージに置き換えられます。

レート制限とキャッシュ

• IP ごとに、MCP HTTP リクエストは 1 分あたり 120 件（RATE_LIMIT_MAX_REQUESTS）に制限されます。また、src/lib/rateLimiter.ts でツールごとに 1 分あたり 10～40 件の制限があります。
• 従来の SSE では、IP ごとのオープンセッションは最大 10 件、合計で最大 300 件です。セッションは 1 時間後に終了します。
• バックエンドの GET レスポンスはメモリ内にキャッシュされます（検索は 60 秒、市区町村／カテゴリは 10 分、市区町村で絞り込んだ商品検索に使用するセール概要は 30 分）。

設定

.env.example を参照してください：BACKEND_URL、PORT（3003）、MCP_PUBLIC_ORIGIN、RATE_LIMIT_MAX_REQUESTS、NODE_ENV。

ローカルでの実行

npm install
npm run build
BACKEND_URL=https://api.finda.sale PORT=3003 npm start

MCP Inspector（npx @modelcontextprotocol/inspector）で http://localhost:3003/mcp に接続して試してください。

レジストリ

公式 MCP Registry 名：sale.finda/findasale（finda.sale の DNS 認証済み名前空間）。 登録手順：claude_docs/operations/mcp-registry-submission-2026-10-23.md。