RDW MCP Server

オランダの RDW（Rijksdienst voor het Wegverkeer）の車両登録データを照会するための Model Context Protocol (MCP) サーバーです。ナンバープレート（kenteken）を指定すると、車両スペック、燃料・排出ガスデータ、APK/点検履歴、登録・所有者履歴、車軸・車体仕様、欠陥コード、リコール未処理状態などを、公式の RDW オープンデータ API からすべて取得します。stdio/npx でローカル実行するか、Cloudflare Workers 上にリモート MCP サーバーとしてデプロイして、claude.ai から直接接続できます。

クイックスタート

お好みの方法を選択してください：

• グローバルインストール（推奨）：npm install -g rdw-mcp-server → rdw-mcp

• NPX（インストール不要）：npx rdw-mcp-server

• ローカル開発：リポジトリをクローン → npm install → npm run build → node build/index.js

• リモート（Cloudflare Workers）：ローカルプロセスは一切不要 - 一度デプロイすれば、claude.ai からカスタムコネクタとして接続できます。リモート MCP サーバーとしてデプロイする を参照してください。

インストールをテストする：

rdw-mcp        # if globally installed
# OR
npx rdw-mcp-server  # if using npx

（停止するには Ctrl+C を押してください）

Claude Desktop に追加する（下記の設定セクションを参照）

次のような質問を試す：

• 「ナンバープレート 12-ABC-3 を検索して」

• 「kenteken 1-ABC-23 の APK 履歴と技術的な欠陥を表示して」

Related MCP server: Car Price MCP Server

機能

• 完全なナンバープレート検索：オランダのナンバープレート（kenteken）で RDW データベースから利用可能な車両情報を取得

• 包括的な車両データ：基本仕様、技術詳細、重量、寸法、登録情報

• 燃料・排出ガス統合データ：燃料タイプの詳細、排出ガス、環境仕様、騒音レベル

• APK 点検履歴：定期点検レポートの履歴と、その結果としての APK 有効期限

• 登録履歴：所有権・登録変更履歴

• 技術仕様：車軸荷重、車体タイプ、詳細な技術データ

• 欠陥記録：点検中に検出された欠陥コード

• リコール未処理状態：車両に現在メーカーリコールが未処理で存在するかどうか

• リアルタイムデータ：公式の RDW データベースから最新情報にアクセス

• リモートまたはローカル：stdio/npx でローカル実行するか、Cloudflare Workers 上にサーバーレスのリモート MCP サーバーとしてデプロイ - リモート MCP サーバーとしてデプロイする を参照

インストール

グローバルインストール（CLI 使用に推奨）

npm install -g rdw-mcp-server

グローバルインストール後、サーバーを直接実行できます：

rdw-mcp

NPX を使用する（インストールせずに実行）

npx rdw-mcp-server

これにより、グローバルにインストールせずにパッケージを直接実行します。

ソースから（ローカル開発）

git clone https://github.com/yourusername/rdw-mcp-server.git
cd rdw-mcp-server
npm install
npm run build
node build/index.js

使用方法

グローバルコマンドとして

グローバルインストール後、MCP サーバーを起動します：

Stdio モード（デフォルト）：

rdw-mcp

HTTP モード：

rdw-mcp --http          # Runs on port 3000
rdw-mcp --http --port=8080  # Custom port

サーバーは stdio と HTTP の両方のトランスポートをサポートしています：

• Stdio：コマンドラインおよび Claude Desktop 統合用

• HTTP：リモートアクセス、Web 統合、スケーラブルなデプロイ用

HTTP トランスポートの機能

HTTP モード（--http）で実行する場合、サーバーは以下を提供します：

• MCP エンドポイント：POST /mcp - メインの MCP プロトコルエンドポイント

• ヘルスチェック：GET /health - サーバーのステータスとバージョン情報

• CORS サポート：Web 統合用にクロスオリジンリクエストを有効化

• ステートレス設計：セッション管理なしで、スケーリングに最適

• エラーハンドリング：適切な HTTP ステータスコードと JSON-RPC エラーレスポンス

HTTP 使用例：

# Start HTTP server
rdw-mcp --http --port=3000

# Health check
curl http://localhost:3000/health

# MCP requests (requires proper JSON-RPC format)
curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

MCP クライアント設定（VS Code）

VS Code の MCP サポート（.vscode/mcp.json）では、明示的な type を持つ servers キーを使用します：

グローバルインストールを使用する場合（推奨）：

{
  "servers": {
    "rdw": {
      "type": "stdio",
      "command": "rdw-mcp"
    }
  }
}

npx を使用する場合（代替）：

{
  "servers": {
    "rdw": {
      "type": "stdio",
      "command": "npx",
      "args": ["rdw-mcp-server"]
    }
  }
}

Claude Desktop の場合は、代わりに下記の Claude Desktop の設定 に示す mcpServers キーを使用してください。

ローカル開発モード

ソースからのローカル開発の場合：

git clone https://github.com/yourusername/rdw-mcp-server.git
cd rdw-mcp-server
npm install
npm run build
node build/index.js

開発モード

自動リビルドを使用した開発の場合：

npm run dev

リモート MCP サーバーとしてデプロイする（Cloudflare Workers）

このリポジトリには、同じ rdw-license-plate-lookup ツールを リモート MCP サーバーとして公開する Cloudflare Worker エントリポイント（src/worker.ts）も含まれています - ローカルプロセスも、トンネルも、コンテナも不要です。このツールは公開されている RDW オープンデータをプロキシするだけ（シークレットもユーザーデータもなし）なので、OAuth なしで claude.ai に追加できます。

これは完全に付加的なものです。前述の npx rdw-mcp-server / Claude Desktop の stdio セットアップには影響しません。

オプション A: Cloudflare ダッシュボードからデプロイする（ローカル CLI 不要）

1. このリポジトリを自分の GitHub アカウントにフォークまたはプッシュします。

2. Cloudflare ダッシュボード で：Workers & Pages → 作成 → Git リポジトリをインポート。

3. Cloudflare の GitHub App を認可し（ワンタイムの OAuth クリック）、リポジトリを選択します。

4. Cloudflare は wrangler.jsonc を自動検出し、ビルド/デプロイコマンドを事前入力します。保存してデプロイ をクリックします。

5. Cloudflare がクラウド上で npm install + wrangler deploy を実行し、https://rdw-mcp-worker.<your-subdomain>.workers.dev のようなライブ URL を提供します。

6. 以降、接続されたブランチへのプッシュのたびに自動的にリビルドおよび再デプロイされます。

オプション B: Wrangler でローカルからデプロイする

npm install
npm run cf:dev          # local Worker at http://localhost:8787

MCP Inspector でローカル検証：

npx @modelcontextprotocol/inspector
# connect to http://localhost:8787/mcp (Streamable HTTP) or http://localhost:8787/sse (SSE)

その後デプロイ：

npx wrangler login   # first time only
npm run deploy

claude.ai に追加する

1. claude.ai → 設定 → コネクタ → カスタムコネクタを追加。

2. デプロイした URL を /mcp パス付きで貼り付けます。例：https://rdw-mcp-worker.<your-subdomain>.workers.dev/mcp

3. OAuth Client ID/Secret フィールドは空白のままにします - このサーバーは認証なしです。

4. 追加 をクリックし、会話内で + → コネクタ から有効化します。

5. 試す：「ナンバープレート 12-ABC-3 を検索して」。

注意事項

• Worker はデプロイすると公開されます - URL を知っていれば誰でもこの Worker 経由で RDW 検索を呼び出せます。既に公開されている RDW データをプロキシするだけで、RDW 側にも認証がないため問題はありませんが、将来書き込み操作やプライベートデータを追加する前にこの点を留意してください（その時点で OAuth プロバイダーを追加してください）。

• Worker は agents パッケージの McpAgent を使用します。これは Durable Object をバックエンドとしており、幅広いクライアント互換性のために /mcp（Streamable HTTP）と /sse（レガシー SSE）の両方を公開します。

利用可能なツール

rdw-license-plate-lookup

オランダのナンバープレートで RDW データベースから車両情報を検索します。

パラメータ：

• kenteken（string）：検索するオランダのナンバープレート

戻り値：

• RDW データベースからの車両情報。以下を含みます：

  • 基本情報：ブランド、モデル、色、タイプ、バリアント、バージョン

  • 技術仕様：エンジン、出力、寸法、シリンダー数、排気量

  • 重量・容量：空車重量、車両重量、牽引能力、車軸荷重

  • 登録データ：初度登録、登録・所有者変更履歴、型式認証

  • 点検記録：APK 有効期限、定期点検レポート履歴、検出された欠陥コード

  • 燃料・排出ガス：燃料タイプ、排出ガスレベル、CO2 クラス、騒音レベル

  • 安全情報：リコール未処理状態（RDW のオープンデータは車両ごとのリコール履歴を公開しておらず、現在リコールが未処理かどうかのみがわかります）

  • 車体仕様：カロッセリータイプ、欧州分類

  • 財務データ：カタログ価格、BPM 税情報

  • ステータス表示：輸出ステータス、タクシー表示、保険ステータス

例： 完全な RDW データベース情報を得るためにナンバープレート「12-ABC-3」を検索

要件

• Node.js：バージョン 18.0.0 以上

• npm：バージョン 8.0.0 以上（Node.js に同梱）

• インターネット接続：RDW API へのアクセスに必要

Claude Desktop の設定

この MCP サーバーを Claude Desktop で使用するには、claude_desktop_config.json に以下を追加します：

グローバルインストールを使用する場合（推奨）

npm install -g rdw-mcp-server でグローバルインストールした場合：

{
  "mcpServers": {
    "rdw": {
      "command": "rdw-mcp"
    }
  }
}

NPX を使用する場合（代替）

グローバルインストールしない場合：

{
  "mcpServers": {
    "rdw": {
      "command": "npx",
      "args": ["rdw-mcp-server"]
    }
  }
}

開発モードのみ

ローカルソースコードでの開発用：

Windows

{
  "mcpServers": {
    "rdw": {
      "command": "node",
      "args": ["C:\\ABSOLUTE\\PATH\\TO\\rdw-mcp\\build\\index.js"]
    }
  }
}

macOS/Linux

{
  "mcpServers": {
    "rdw": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/rdw-mcp/build/index.js"]
    }
  }
}

データソース

このサーバーは公式の RDW（オランダ車両庁）オープンデータ API を使用し、opendata.rdw.nl に対してライブで検証されています：

• ベース API：https://opendata.rdw.nl/resource/

• 車両登録：データセット m9d7-ebf2 - 基本車両情報と仕様

• 燃料・排出ガス：データセット 8ys7-d773 - 燃料タイプ、排出ガス、環境データ

• APK / 点検レポート：データセット sgfe-77wx（「Meldingen Keuringsinstantie」）- 定期点検レポート履歴と結果としての APK 有効期限

• 登録履歴：データセット db8s-mw3u（「Kenteken-tenaamstelling」）- 登録・所有者変更履歴

• 車軸仕様：データセット 3huj-srit - 技術的な車軸荷重仕様

• 車体タイプ：データセット vezc-m2t6 - カロッセリーおよび車体タイプの分類

• 技術的欠陥：データセット a34c-vvps（「Geconstateerde Gebreken」）- 点検中に検出された欠陥コード

注：RDW のオープンデータは、車両ごとのリコールデータセット（ナンバープレートフィールドのない一般的なリコールキャンペーンカタログのみ）も、車両ごとの個別の色履歴データセットも公開していません - 色は基本車両レコードに既に含まれています。リコール未処理状態は、代わりに基本車両レコードのフラグから取得されます。

すべてのデータは公式の政府ソースからリアルタイムで取得され、公開されています。

プライバシーとデータ使用

• データ保存なし：このサーバーは車両データをローカルに保存しません

• リアルタイムクエリ：すべてのリクエストは RDW API に直接転送されます

• 公開データのみ：公開されている登録データのみにアクセスします

• 認証なし：個人情報や機密データは不要で、処理もされません

レート制限

RDW API はレート制限を課す場合があります。レート制限に遭遇した場合：

• リクエスト間で数秒待つ

• 連続して大量のリクエストを行わない

• アプリケーションロジックに遅延を実装することを検討する

クエリ例

Claude Desktop などの MCP クライアントに接続すると、次のような質問ができます：

完全な車両情報：

• 「ナンバープレート 12-ABC-3 を検索して」

• 「kenteken XYZ-123 について利用可能な情報は？」

• 「ナンバープレート 1-ABC-23 の車両について教えて」

• 「ナンバープレート ABC-12-D のすべてのデータを表示して」

• 「kenteken DEF-456 の完全な RDW 情報を取得して」

特定情報のリクエスト：

• 「kenteken ABC-12-D の排出ガスデータは？」

• 「ナンバープレート XYZ-456 の APK 履歴を表示して」

• 「車両 12-ABC-3 にリコールはありますか？」

• 「kenteken DEF-456 の登録履歴は？」

• 「ナンバープレート GHI-789 の技術的欠陥を表示して」

技術・安全の詳細：

• 「車両 12-ABC-3 の牽引能力は？」

• 「kenteken XYZ-456 の車軸仕様を表示して」

• 「ナンバープレート ABC-12-D に未処理のリコールはありますか？」

• 「kenteken DEF-456 の点検中に見つかった欠陥は？」

• 「ナンバープレート GHI-789 の完全な点検履歴を表示して」

技術詳細

• 言語：TypeScript

• ランタイム：Node.js（stdio / HTTP）または Cloudflare Workers（リモート MCP）

• プロトコル：Model Context Protocol (MCP)

• トランスポート：標準入出力（stdio）、Streamable HTTP、または SSE（Cloudflare Workers デプロイ）

• 検証：入力検証用の Zod スキーマ

• API：RDW オープンデータエンドポイントへの RESTful 呼び出し

エラーハンドリング

サーバーは以下の包括的なエラーハンドリングを含みます：

• 無効なナンバープレート（形式が間違っている、または存在しない）

• ネットワーク接続の問題

• API のレート制限とタイムアウト

• RDW API からのデータ欠落または不正なデータ

• 無効な検索パラメータ

トラブルシューティング

一般的な問題

サーバーが起動しない：

• Node.js のバージョンが 18.0.0 以上であることを確認：node --version

• 再インストールを試す：npm uninstall -g rdw-mcp-server && npm install -g rdw-mcp-server

データが返されない場合:

• インターネット接続を確認してください

• ナンバープレートの形式を確認してください（オランダのプレート: XX-XXX-X、XXX-XX-X など）

• 一部の旧車両では、RDW データベースに完全なデータが存在しない場合があります

Claude Desktop の接続問題:

• 設定がインストール方法（グローバル vs npx）と一致しているか確認してください

• グローバルインストールを使用している場合、ターミナルで rdw-mcp コマンドが動作することを確認してください

• npx を使用している場合、ターミナルで npx rdw-mcp-server が動作することを確認してください

• 設定変更後は Claude Desktop を再起動してください

• 開発環境では、絶対パスとビルドディレクトリが正しいことを確認してください

サポートの受け方

問題が発生した場合:

1. コンソール出力でエラーメッセージを確認してください

2. ナンバープレートの形式がオランダの基準に適合しているか確認してください

3. 既知の有効なナンバープレートでテストしてください

4. アクティブなインターネット接続があることを確認してください

ライセンス

MIT

貢献

貢献を歓迎します！この MCP サーバーは、追加の RDW データセットや機能で拡張できます。

開発環境のセットアップ

1. リポジトリをクローン:

   git clone https://github.com/jodur/rdw-mcp-server.git
   cd rdw-mcp-server

2. 依存関係をインストール:

   npm install

3. ビルドとテスト:

   npm run build
   npm start

利用可能な RDW データセット

RDW は、上記で使用されているもの以外にも、統合できる多くのデータセットを提供しています:

• タクシーおよびバスの登録

• 燃料別の技術的バリエーション

• 輸出入の車両履歴

コードスタイル

• 厳密な型指定で TypeScript を使用

• 既存のコードパターンに従う

• すべての関数に JSDoc コメントを追加

• 入力検証に Zod を使用

• 適切なエラーハンドリングを含める

変更履歴

バージョン 2.3.0

• 新機能: Cloudflare Workers 上のリモート MCP サーバー: src/worker.ts を追加。Cloudflare ダッシュボード（Git 統合、CLI 不要）または wrangler deploy でデプロイ可能。/mcp（Streamable HTTP）と /sse を公開し、認証なしで claude.ai からカスタムコネクタとして直接接続できます。

• 共有ツールロジック: RDW ルックアップツールを src/rdw-lib.ts に抽出し、Node エントリポイントと Worker の両方で変更なしでインポート。ロジックの重複なし、既存の stdio/HTTP 配布の動作変更なし。

• データギャップの修正: ツールは以前、APK 履歴、リコール、所有履歴、欠陥を返すと主張していましたが、実際には取得していませんでした（「エンドポイントが存在しない」という想定が誤りでした）。opendata.rdw.nl に対してライブで検証し、APK/点検履歴（sgfe-77wx）、登録/所有履歴（db8s-mw3u）、検出された欠陥（a34c-vvps）の実際のデータセットを接続しました。

• 主張の修正: ツールの説明と README は、RDW のオープン API が実際には公開していないリコール履歴や車両別の色履歴データを主張しなくなりました。リコールステータスは、履歴ではなくオープン/クローズのフラグとして正確に説明されるようになりました。

バージョン 2.1.0

• 新しいトランスポート: Streamable HTTP トランスポートのサポートを追加（ステートレス）

• SDK 準拠: 最新の MCP TypeScript SDK パターンに更新

• HTTP 機能: /mcp エンドポイントと /health チェックを備えた Express.js サーバー

• コマンドライン: HTTP モード用に --http および --port=N 引数を追加

• CORS サポート: Web 統合用にクロスオリジンリクエストを有効化

• ステートレス設計: リクエストごとに新しいサーバーインスタンスを作成し、スケーリングに最適

• 最新 API: 非推奨の server.tool() から server.registerTool() に更新

• 構造の強化: 関数を分離してコード構成を改善

• デュアルトランスポート: stdio（デフォルト）と HTTP トランスポートの両方をサポート

バージョン 2.0.0

• 大幅な拡張: 1 回のルックアップで利用可能なすべての RDW データベースをクエリするようになりました

• APK 点検履歴と記録を追加

• 車両リコールと安全措置情報を追加

• 完全な登録/所有履歴を追加

• 車軸荷重仕様と技術データを追加

• ボディタイプと車体分類を追加

• 技術的欠陥記録と点検結果を追加

• 追加の色情報を追加

• パフォーマンス向上のための並列データフェッチを強化

• 8 つ以上の RDW データセットからの包括的な車両データ

• ツールの説明とドキュメントを更新

バージョン 1.1.0

• 破壊的変更: 単一の包括的なルックアップツールに簡素化

• すべての燃料および排出ガスデータをメインのナンバープレートルックアップに統合

• 別個の燃料/排出ガスおよび車両検索ツールを削除

• 排出ガスコードと煤排出ガスを含む燃料/排出ガスデータ表示を強化

• 単一クエリでのデータ完全性を改善

バージョン 1.0.2

• npm ユーザー向けの包括的な README の改善

• インストールおよび使用手順の強化

• トラブルシューティングとプライバシーセクションを追加

• サンプルクエリと開発環境セットアップの改善

• 削除されたテストファイルへの package.json 参照を修正

バージョン 1.0.1

• 車両データ出力の強化

• ナンバープレート正規化の改善

• 包括的なエラーハンドリングの追加

• ドキュメントの強化

バージョン 1.0.0

• 初回リリース

• 基本的なナンバープレートルックアップ

• 燃料および排出ガスデータ

• ブランド/モデルによる車両検索

免責事項

このサーバーは公開 RDW データを使用しており、公式の RDW 組織とは提携していません。重要な車両情報は、常に公式チャネルを通じて確認してください。