RDW MCP 서버

네덜란드 RDW(네덜란드 도로교통청) 차량 등록 데이터를 조회하기 위한 Model Context Protocol(MCP) 서버입니다. 번호판(켄텐)을 입력하면 차량 제원, 연료/배출가스 데이터, 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 조회해 줘"

• "켄텐 1-ABC-23의 APK 이력과 기술적 결함을 보여 줘"

Related MCP server: Car Price MCP Server

기능

• 완전한 번호판 조회: 네덜란드 번호판(켄텐)으로 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: 원격 액세스, 웹 통합, 확장 가능한 배포용

HTTP 전송 기능

HTTP 모드(--http)로 실행하면 서버는 다음을 제공합니다:

• MCP 엔드포인트: POST /mcp - 기본 MCP 프로토콜 엔드포인트

• 상태 확인: GET /health - 서버 상태 및 버전 정보

• CORS 지원: 웹 통합을 위한 교차 출처 요청 활성화

• 무상태 설계: 세션 관리가 필요 없어 확장에 적합

• 오류 처리: 적절한 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 앱을 승인하고(일회성 OAuth 클릭) 저장소를 선택합니다.

4. Cloudflare가 wrangler.jsonc를 자동으로 감지하여 빌드/배포 명령을 미리 채웁니다. 저장 및 배포를 클릭합니다.

5. Cloudflare가 클라우드에서 npm install + wrangler deploy를 실행하고 라이브 URL(예: https://rdw-mcp-worker.<your-subdomain>.workers.dev)을 제공합니다.

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 클라이언트 ID/비밀번호 필드는 비워 둡니다. 이 서버는 인증이 필요 없습니다.

4. 추가를 클릭합니다.

5. "번호판 12-ABC-3 조회"와 같은 질문을 해 봅니다.

참고 사항

• Worker는 배포되면 공개됩니다. URL을 가진 사람은 누구나 이를 통해 RDW 조회를 호출할 수 있습니다. 이는 이미 공개된 RDW 데이터만 프록시하므로 괜찮습니다. 나중에 쓰기 작업이나 개인 데이터를 추가하기 전에 이 점을 명심하세요.

• Worker는 Durable-Object 기반의 McpAgent( agents 패키지)를 사용하여 /mcp(Streamable HTTP) 및 /sse(레거시 SSE)를 노출합니다.

사용 가능한 도구

rdw-license-plate-lookup

네덜란드 번호판으로 RDW 데이터베이스에서 차량 정보를 조회합니다.

매개변수:

• kenteken (문자열): 조회할 네덜란드 번호판

반환:

• RDW 데이터베이스의 차량 정보:

  • 기본 세부 정보: 브랜드, 모델, 색상, 유형, 변형, 버전

  • 기술 사양: 엔진, 출력, 치수, 실린더, 배기량

  • 중량 및 적재 용량: 공차 중량, 공차 중량, 견인 용량, 차축 하중

  • 등록 데이터: 최초 등록, 등록/소유권 변경 이력, 형식 승인

  • 검사 기록: APK 만료일, 정기 검사 보고서 이력, 결함 코드

  • 연료 및 배출가스: 연료 유형, 배출가스 수준, CO2 등급, 소음 수준

  • 안전 정보: 리콜 여부 (RDW 공개 데이터는 차량별 리콜 이력을 노출하지 않음)

  • 차체 사양: 차체 유형, 유럽 분류

  • 재무 데이터: 카탈로그 가격, BPM 세금 정보

  • 상태 표시기: 수출 상태, 택시 표시기, 보험 상태

예: "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에 다음을 추가하세요:

전역 설치 사용 (권장)

{
  "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"]
    }
  }
}

데이터 소스

이 서버는 opendata.rdw.nl에 대해 실시간으로 검증된 공식 RDW(네덜란드 차량 당국) 공개 데이터 API를 사용합니다:

• 기본 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 공개 데이터는 차량별 리콜 데이터 세트(번호판 필드가 없는 일반 리콜 캠페인 카탈로그)를 노출하지 않습니다. 리콜 상태는 기본 차량 레코드의 플래그에서 가져옵니다.

문제 해결

일반적인 문제

서버가 시작되지 않는 경우:

• Node.js 버전이 18.0.0 이상인지 확인하세요: node --version

• 재설치를 시도하세요: npm uninstall -g rdw-mcp-server && npm install -g rdw-mcp-server

라이선스

MIT

데이터가 반환되지 않음:

• 인터넷 연결을 확인하세요

• 번호판 형식을 확인하세요 (네덜란드 번호판: 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 이력, 리콜, 소유권 이력 및 결함을 반환한다고 주장했지만 실제로는 가져오지 않았습니다(endpoint doesn't exist 가정이 잘못된 것으로 판명됨). 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 지원: 웹 통합을 위한 교차 출처 요청 활성화

• 상태 비저장 설계: 요청당 새 서버 인스턴스, 확장에 적합

• 최신 API: 더 이상 사용되지 않는 server.tool()에서 server.registerTool()로 업데이트

• 향상된 구조: 분리된 함수로 더 나은 코드 구성

• 이중 전송: stdio(기본값) 및 HTTP 전송 모두 지원

버전 2.0.0

• 주요 개선: 단일 조회에서 사용 가능한 모든 RDW 데이터베이스를 쿼리

• APK 검사 이력 및 기록 추가

• 차량 리콜 및 안전 조치 정보 추가

• 완전한 등록/소유권 이력 추가

• 차축 하중 사양 및 기술 데이터 추가

• 차체 유형 및 carrosserie 분류 추가

• 기술 결함 기록 및 검사 결과 추가

• 추가 색상 정보 추가

• 성능 향상을 위한 병렬 데이터 가져오기 강화

• 8개 이상의 RDW 데이터셋에서 포괄적인 차량 데이터

• 도구 설명 및 문서 업데이트

버전 1.1.0

• 주요 변경: 단일 포괄 조회 도구로 단순화

• 모든 연료 및 배출 데이터를 기본 번호판 조회에 통합

• 별도의 연료/배출 및 차량 검색 도구 제거

• 배출 코드 및 매연 배출량으로 연료/배출 데이터 표시 강화

• 단일 쿼리에서 데이터 완전성 개선

버전 1.0.2

• npm 사용자를 위한 포괄적인 README 개선

• 설치 및 사용 지침 강화

• 문제 해결 및 개인정보 보호 섹션 추가

• 예제 쿼리 및 개발 설정 개선

• 제거된 테스트 파일에 대한 package.json 참조 수정

버전 1.0.1

• 차량 데이터 출력 강화

• 번호판 정규화 개선

• 포괄적인 오류 처리 추가

• 문서 강화

버전 1.0.0

• 최초 릴리스

• 기본 번호판 조회

• 연료 및 배출 데이터

• 브랜드/모델별 차량 검색

면책 조항

이 서버는 공개 RDW 데이터를 사용하며 공식 RDW 기관과 제휴하지 않습니다. 중요한 차량 정보는 항상 공식 채널을 통해 확인하세요.