Plateop vehicle check

plateop-check-mcp

Plateop から中古車に関する無料の情報を AI エージェントに提供する、リモート MCP サーバー（Streamable HTTP、ステートレス）です。登録データ、車検の期限、走行距離計の判定、保険、車検での指摘事項、リコール情報を、それぞれ情報源と基準日とともに提供します。Plateop の公開 JSON チャネル（GET /api/rapport/kenteken/{plate}、GET /open/model/<brand>/<model>.json）を薄くラップしたものです。データレイヤー、キャッシュ、データベース、アカウントはありません。

収益モデル：すべての vehicle_check の回答の末尾に、国別ホストの有料レポート（オランダでは 4.95 ユーロ）へのリンク https://<host>.plateop.com/analyse/nieuw を、人が利用できるように記載します。URL にナンバープレートは含めません。エージェントから送信された Authorization ヘッダーは変更せずにアプリへ渡されるため、将来有料プランを導入しても、ここを変更する必要はありません。

ソース：https://github.com/gvb9/plateop-check-mcp。デプロイ方法：`./server-setup.sh` を一度実行し、その後 ./deploy.sh を実行します。MCP Registry に com.plateop/plateop-check 0.1.0 として公開済みです（2026 年 10 月 18 日）。新しいバージョンを公開するには、バージョンを上げて mcp-publisher login http と mcp-publisher publish を実行します（agent-commons docs/VINDBAARHEID.md を参照）。

ツール

ツール	機能	Plateop の呼び出し
vehicle_check(plate, country, language?)	見出しごとの情報をテキストで返し、structuredContent に生の JSON を格納した後、有料レポートへの案内を記載します	/api/rapport/kenteken/{plate}?taal=
model_inspection_stats(brand, model, country, language?)	情報源と年式ごとに、最も頻度の高い車検の指摘事項を 3 件返します（アプリには 300 件すべてが掲載されており、回答から完全な JSON にリンクします）。出典表記も含みます	/open/model/<brand-slug>/<model-slug>.json

対象国：nl（host nederland）、gb（uk）、il（israel）、is（island）、dk（danmark）。各呼び出しでは、Host と X-Forwarded-Host: <host>.plateop.com（アプリは Host を読み取ります。fetch では設定できないため、node:http を使用します）、エージェントの IP を指定した X-Real-IP と X-Forwarded-For、およびエージェントに Authorization ヘッダーがある場合はそのヘッダーを送信します。タイムアウトは 10 秒です。アプリのエラー（400、404、Retry-After を伴う 429、502、503）は、エージェント向けのプレーンな一文に変換されます。

ルート：POST /mcp、GET /（テキスト）、/llms.txt（ガイド）、/health、/privacy、/icon.svg、/.well-known/mcp/server-card.json。server.json は MCP Registry（com.plateop/plateop-check）用です。

意図的に含めていない機能：compare_models。アプリの /open/vergelijk/<pair>.json が応答するのは、nl、gb、cz の限られた固定モデルペアのみで、一覧を取得する方法もありません。そのため、ツールを追加しても、ほとんどの場合「見つかりません」を返すことになります。エージェントから要望があれば追加します。

制限（ハッシュ化した IP ごと、メモリ内）

vehicle_check は 10 分あたり 20 回、1 日あたり 100 回（アプリ独自の制限と同じ）。モデルのツールは 1 分あたり 60 回、通常の GET ルートは 1 時間あたり 600 回です。タイマーもディスクへの書き込みもありません。古いウィンドウは使用時に削除され、再起動するとすべてリセットされます。

環境変数

変数	意味
PORT	リッスンポート。デフォルトは 3200 です
PLATEOP_BASE_URL	Plateop アプリ。デフォルト値および本番環境の値は http://127.0.0.1:3105 です
TRUST_PROXY	nginx の背後で動作させる場合は 1 を設定し、X-Real-IP／X-Forwarded-For から呼び出し元の IP を読み取ります
IP_SALT	任意。IP ハッシュのソルトです。未設定の場合、起動ごとにランダムな値を使用します（制限とログ内のハッシュは再起動時にリセットされます）

DATA_DIR はありません。ディスクには何も書き込みません。

実行

npm install
npm test        # vitest against a fake Plateop (test/fakePlateop.ts); no real calls
npm run build
PLATEOP_BASE_URL=http://127.0.0.1:3105 TRUST_PROXY=1 npm start

展開（まだ何も実施されていません）

1. サーバー上で、useradd --system plateop-check、mkdir -p /srv/plateop-check /etc/plateop-check を実行し、環境ファイル /etc/plateop-check/plateop-check.env（root:plateop-check、モード 640）に PORT=3200、PLATEOP_BASE_URL=http://127.0.0.1:3105、TRUST_PROXY=1 を設定します。
2. systemd ユニット plateop-check を（commons と同様に）作成します。ExecStart=/usr/bin/node /srv/plateop-check/current/dist/index.js、EnvironmentFile=、User=plateop-check、Restart=on-failure を設定します。
3. Cloudflare の背後で check.plateop.com を設定する nginx サイト zz-plateop-check を（zz-commons と同様に）作成します。proxy_pass http://127.0.0.1:3200、proxy_set_header X-Real-IP $remote_addr（または Cloudflare IP モジュールの値）、X-Forwarded-Proto、Host を設定します。DNS の変更は不要です。*.plateop.com はすでにサーバーを指しています。
4. プライバシーページでは、ジャーナルが呼び出しログを最大 30 日間保持すると説明しています。/etc/systemd/journald.conf に MaxRetentionSec=30day を設定するか、src/privacy.ts の文言を変更します。
5. ./deploy.sh を実行し、続けて curl https://check.plateop.com/health を実行した後、MCP クライアントで vehicle_check を 1 回実行します。
6. server.json を com.plateop として MCP Registry に公開します。
7. 30 日後に、ツールごと、および短縮ハッシュごとの呼び出し数を集計します。journalctl -u plateop-check | grep tool=。