Polovnjak MCP

中古車マーケットプレイス向けのマルチプロバイダー MCP サーバーです。エージェントは、検索、掲載詳細、価格統計、価格履歴、ユーザーごとの保存済み検索ウォッチという統一されたツール面を1つ利用でき、プラグイン可能なマーケットプレイスアダプターで支えられています。同梱アダプター: polovniautomobili.com（ソースID pa）と mojauto.rs（ソースID ma）。いずれもセルビアのサイトです。

ユーザーは標準の MCP OAuth 2.1 フローを介して Google でサインインします。ウォッチはユーザーごとにプライベートです。ハブが観測したすべての掲載（任意のユーザーの検索、統計サンプリング、ウォッチチェックのいずれによるものも）は、共有 Postgres の「マーケットメモリ」に記録され、どのマーケットプレイスも単独では提供しない価格履歴とトレンドクエリを支えます。

アーキテクチャ

• アダプター（src/adapters/）は共通の SourceAdapter インターフェース（search、getListing、getMakesModels、および機能フラグ）を実装します。各アダプターは正規のフィルターをプロバイダーのクエリに変換し、結果を正規の掲載モデルにマッピングし直します。掲載には pa:12345678 や ma:3554254 のような複合IDが付きます。メーカー名はソースごとにエイリアス解決されます（"VW" と "Volkswagen" はどこでも両方機能します）。ソースが表現できないフィルターは、結果内のソース別 warnings として報告されます。

• ツール（src/tools/）はアダプター全体にファンアウトして結果をマージし、すべてにソースをタグ付けします。カテゴリは、乗用車、オートバイ、バン、軽/大型トラック、バス、トレーラー、キャンピングカー、建設機械、トラクター、ボート、自転車をカバーします。

• レコーダー（src/recorder.ts）は観測されたすべての掲載を listings にアップサートし、初回発見時または価格変更時に price_observations 行を追加します。

• 認証（src/auth/）はセルフホスト型 OAuth 2.1 認可サーバー（動的クライアント登録、PKCE、リフレッシュトークン）で、Google OIDC をアイデンティティ層として使用します。トークンは Postgres にハッシュ化されて保存されます。

• ストレージは Drizzle ORM を介した Postgres です。マイグレーションは起動時に自動的に実行されます。

Related MCP server: Vehicle Database MCP Server

クイックスタート（Docker Compose）

1. Google Cloud Console で Google OAuth クライアント（タイプ「ウェブアプリケーション」）を作成し、認証済みリダイレクト URI を <PUBLIC_URL>/auth/google/callback（ローカル使用の場合は例: http://localhost:8321/auth/google/callback）に設定します。

2. 環境を設定します:

cp .env.example .env
# set GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET (and PUBLIC_URL for non-local deployments)

3. すべてを起動します（MCP サーバー + Postgres + FlareSolverr）:

docker compose up -d --build

4. MCP クライアントを http://localhost:8321/mcp に向けます。クライアントは OAuth メタデータを発見し、自身を登録し、Google サインイン用のブラウザウィンドウを開きます。以降はすべてユーザーごとです。

Google 認証情報なしでローカルで簡単にテストするには、AUTH_MODE=none を設定します。サーバーは認証をスキップし、単一のローカル開発ユーザーを使用します。

ツール

エージェントスキル

リポジトリには .cursor/skills/car-market-hub/SKILL.md にエージェントスキルが同梱されており、LLM エージェントにこのサーバーを効果的に使用する方法（ツールワークフロー、落とし穴）を教え、OpenAI、Claude、LibreChat、Cursor 向けのクライアント別接続ガイドが clients.md にあります。Cursor は自動的に取得します。他のプラットフォームでは、スキルディレクトリをそのプラットフォームのスキル場所（例: .claude/skills/）にコピーするか、その内容をエージェントの指示に貼り付けます。

ウォッチワークフロー

1. 名前とフィルター（必要に応じて特定の sources に制限）で create_watch を呼び出します。現在の一致がベースラインになります。

2. 後で（例: スケジュールされたプロンプト「車のウォッチを確認して」）、check_watches は、ウォッチごと、ソースごとに、それ以降に出現した掲載のみを返します。

新しいマーケットプレイスアダプターの追加

1. src/adapters/<name>/ を作成し、src/adapters/types.ts の SourceAdapter インターフェースを実装します: 短く安定した id（複合掲載IDで使用）を選び、正規の SearchQuery フィルターをプロバイダーのクエリに変換し、生の結果を src/domain/listing.ts の正規の ListingSummary / ListingDetail 形状にマッピングします。

2. src/server.ts で registerAdapter(...) を使って登録します。

検索ファンアウト、ウォッチ、記録、価格履歴は新しいソースを自動的に拾います。

環境変数

ローカル開発

npm install
docker compose up -d postgres        # or point DATABASE_URL at your own Postgres
AUTH_MODE=none npm run dev           # server on http://localhost:8080/mcp

スキーマ変更: src/db/schema.ts を編集し、npm run db:generate を実行して drizzle/ の下に新しいマイグレーションを生成します（起動時に自動的に適用されます）。

注意事項と制限

• polovniautomobili.com には公開 API がありません。アダプターは Chrome TLS 偽装（impit）を使用してサイトの Next.js データエンドポイントを読み取り、Cloudflare チャレンジフォールバックとして FlareSolverr を使用します。責任を持って使用し、サイトの利用規約を尊重してください。

• 100 EUR 未満の価格は「価格問い合わせ」として扱われ、統計と観測から除外されます。

• ウォッチチェックはソースごとに最初の2ページ（約50件の最新掲載）をスキャンします。

• get_price_history はこのハブを通じて観測された掲載のみを反映します。成長するサンプルであり、完全な市場ではありません。

• 以前のシングルプロバイダー実装は参照用に old/ に保持されています（ビルドには含まれません）。