RDW MCP服务器
](https://badge.fury.io/js/rdw-mcp-server) 
用于查询荷兰RDW（Rijksdienst voor het Wegverkeer）车辆登记数据的模型上下文协议（MCP）服务器。该服务器提供了查找车辆信息、燃油/排放数据的工具，并使用官方RDW开放数据API按品牌和型号搜索车辆。
快速开始
选择您喜欢的方法：
- 全局安装 （推荐）：
npm install -g rdw-mcp-server→rdw-mcp - NPX （无需安装）：
npx rdw-mcp-server - 本地开发人员：克隆仓库→
npm install→npm run build→node build/index.js
测试安装：
rdw-mcp # if globally installed
# OR
npx rdw-mcp-server # if using npx（按Ctrl+C停止）
添加到克劳德桌面 （见下面的配置部分）
开始问以下问题：
- “查找车牌12-ABC-3”
- “给我看看宝马汽车”
特性
- 完成车牌查找：通过荷兰车牌（kenteken）从RDW数据库中获取所有可用的车辆信息
- 全面的车辆数据：基本规格、技术细节、重量、尺寸和注册信息
- 综合燃料和排放：详细的燃料类型、排放、环境规范和声级
- APK检查历史：完整的APK（MOT）检查记录和到期日期
- 安全与召回：车辆召回信息和安全行动通知
- 注册历史：完整的所有权和注册变更历史
- 技术规格：轴载荷、车身类型和详细技术数据
- 缺陷记录：已知的技术缺陷和检查结果
- 实时数据：从所有官方RDW数据库获取最新信息
- 增强覆盖范围：单次查找中来自8个以上不同RDW数据集的数据
安装
全局安装（建议用于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服务器：
标准模式（默认）：
rdw-mcpHTTP模式：
rdw-mcp --http # Runs on port 3000
rdw-mcp --http --port=8080 # Custom port服务器支持stdio和HTTP传输：
- 工作室：用于直接命令行和Claude Desktop集成
- 超文本传输协议：用于远程访问、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客户端配置中
添加到您的MCP客户端配置中（例如，Claude Desktop）：
使用全局安装（推荐）：
{
"servers": {
"rdw": {
"command": "rdw-mcp"
}
}
}使用npx（替代方案）：
{
"servers": {
"rdw": {
"command": "npx",
"args": ["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发展模式
对于自动重建的开发：
npm run dev可用工具
rdw-license-plate-lookup
按荷兰车牌从RDW数据库中查找所有可用的车辆信息。
参数：
kenteken（string）：荷兰车牌要查
退货：
- 来自所有RDW数据库的完整车辆信息，包括：
- 基本细节：品牌、型号、颜色、类型、变体、版本 - 技术规格：发动机、功率、尺寸、气缸、排量 - 重量和容量：空重、整备质量、牵引能力、轴载荷 - 注册数据：首次注册、所有权历史、型式批准 - 检查记录：APK到期日期、检查历史、技术缺陷 - 燃料和排放：燃料类型、排放水平、二氧化碳等级、声级 - 安全信息：召回通知、安全措施、公开召回 - 车身规格：Carrosserie型，欧洲分类 - 财务数据：目录价格、BPM税务信息 - 状态指示灯：出口状态、出租车指示器、保险状态
例子： 查找车牌“12-ABC-3”以获取完整的RDW数据库信息
需求
- Node.js：18.0.0或更高版本
- npm：8.0.0或更高版本（附带Node.js）
- Internet连接：访问RDW API时必需
Claude桌面配置
要将此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"]
}
}
}仅开发模式
使用本地源代码进行开发：
视窗
{
"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：
- API基础:
https://opendata.rdw.nl/resource/ - 车辆登记：数据集
m9d7-ebf2-车辆基本信息和规格 - 燃料和排放：数据集
8ys7-d773-燃料类型、排放和环境数据 - APK检查：数据集
2wi1-7t2k-APK（MOT）检查历史和到期日期 - 召回和安全：数据集
j3wq-qf4v-车辆召回和安全行动通知 - 车轴规格：数据集
3huj-srit-技术轴载荷规格 - 车身类型：数据集
vezc-m2t6-Carrosserie和体型分类 - 车辆颜色：数据集
t8be-g8yr-附加颜色信息 - 技术缺陷：数据集
hx2c-gt41-已知缺陷和检查结果
所有数据均从政府官方来源实时检索，并可公开获取。
隐私和数据使用
- 无数据存储：此服务器不在本地存储任何车辆数据
- 实时查询：所有请求都直接转发到RDW API
- 仅限公共数据：只访问公开的注册数据
- 无认证：不需要或处理任何个人或敏感数据
速率限制
RDW API可能会对费率进行限制。如果遇到速率限制：
- 在请求之间等待几秒钟
- 避免快速连续地提出批量请求
- 考虑在应用程序逻辑中实现延迟
查询示例
连接到Claude Desktop等MCP客户端后，您可以提出以下问题：
完整的车辆信息：
- “查找车牌12-ABC-3”
- “kenteken XYZ-123有什么信息？”
- “告诉我车牌为1-ABC-23的车辆的情况”
- “显示车牌ABC-12-D的所有数据”
- “获取kenteken DEF-456的完整RDW信息”
具体信息请求：
- “肯特肯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
- 协议：模型上下文协议（MCP）
- 运输：标准I/O（stdio）
- 验证：用于输入验证的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桌面连接问题：
- 验证您的配置是否与安装方法匹配（全局与npx）
- 如果使用全局安装，请确保
rdw-mcp命令在终端中工作 - 如果使用npx，请确保
npx rdw-mcp-server在码头工作 - 配置更改后重新启动Claude Desktop
- 对于开发设置，请确保绝对路径和构建目录正确
获取帮助
如果您遇到问题：
- 检查控制台输出是否有错误消息
- 验证您的车牌格式是否符合荷兰标准
- 使用已知有效车牌进行测试
- 确保您有活动的互联网连接
许可证
麻省理工学院
贡献
欢迎投稿！此MCP服务器可以扩展其他RDW数据集或功能。
开发设置
- 克隆存储库：
git clone https://github.com/jodur/rdw-mcp-server.git
cd rdw-mcp-server- 安装依赖项：
npm install- 构建和测试：
npm run build
npm start可用的RDW数据集
RDW提供了更多可以集成的数据集：
- APK（MOT）检查结果
- 车辆召回
- 出租车和公交车登记
- 车辆所有权变更
- 技术缺陷数据
代码的风格
- 使用具有严格类型的TypeScript
- 遵循现有的代码模式
- 为所有功能添加JSDoc注释
- 使用Zod进行输入验证
- 包括适当的错误处理
更新日志
版本2.1.0
- 新交通工具：添加了流式HTTP传输支持（无状态）
- SDK合规性：更新到现代MCP TypeScript SDK模式
- HTTP功能：Express.js服务器
/mcp端点和/health检查 - 命令行：已添加
--http和--port=NHTTP模式的参数 - CORS支持：为web集成启用了跨源请求
- 无状态设计：每个请求都有新的服务器实例，非常适合扩展
- 现代API：已从弃用更新
server.tool()到server.registerTool() - 增强型结构：更好的代码组织，功能分离
- 双重运输：支持stdio（默认）和HTTP传输
版本2.0.0
- 重大改进：现在可以在一次查找中查询所有可用的RDW数据库
- 添加了APK检查历史和记录
- 增加了车辆召回和安全行动信息
- 添加了完整的注册/所有权历史记录
- 增加了轴重规格和技术数据
- 增加了体型和家乐福分类
- 增加了技术缺陷记录和检查结果
- 添加了其他颜色信息
- 增强的并行数据获取，以提高性能
- 来自8+RDW数据集的全面车辆数据
- 更新工具说明和文档
版本1.1.0
- 突破性变化：简化为单一的综合查找工具
- 将所有燃油和排放数据集成到主车牌查找中
- 删除了单独的燃料/排放和车辆搜索工具
- 增强的燃油/排放数据显示，带有排放代码和烟尘排放
- 提高了单个查询中的数据完整性
版本1.0.2
- 面向npm用户的全面README改进
- 增强的安装和使用说明
- 添加了故障排除和隐私部分
- 改进了示例查询和开发设置
- 修复了package.json对已删除测试文件的引用
版本1.0.1
- 增强的车辆数据输出
- 改进了车牌规范化
- 添加了全面的错误处理
- 增强文档
版本1.0.0
- 初始版本
- 基本车牌查找
- 燃料和排放数据
- 按品牌/型号搜索车辆
免责声明
此服务器使用公共RDW数据，不隶属于官方RDW组织。始终通过官方渠道核实关键车辆信息。