AI导哈

车辆信息查询服务

MotorAPI MCP Server 是一个用于查询丹麦车辆注册信息的服务，支持通过车牌号或VIN获取车辆详细信息、环境数据和设备列表。

  • by ShredderAlex
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ShredderAlex/motorapi-mcp

使用说明

MotorAPI MCP服务器

MCP（模型上下文协议）集成 MotorAPI.cn -丹麦车辆登记查询服务。

特性

此MCP服务器提供按注册号或VIN查找丹麦车辆信息的工具：

  • get_vehicle：获取详细的车辆信息（品牌、型号、年份、规格等）
  • get_vehicle_environment：获取环境数据（排放、燃料消耗、环境等级）
  • 获取设备：获取设备和功能列表
  • 获取图片：检查API使用统计信息和配额

安装

先决条件

  • Python 3.10或更高版本
  • 点

设置

  1. 克隆存储库：
git clone https://github.com/ShredderAlex/motorapi-mcp.git
cd motorapi-mcp
  1. 安装依赖项：
pip install -r requirements.txt
  1. （可选）将API密钥设置为环境变量：
export MOTORAPI_KEY="your-api-key-here"

注意：测试中包含了一个默认的API密钥，但您应该从 MotorAPI.cn

用法

运行服务器

运行MCP服务器：

python server.py

与Claude Desktop一起使用

将此配置添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\\Claude\\claude_desktop_config.json

{
  "mcpServers": {
    "motorapi": {
      "command": "python",
      "args": ["/path/to/motorapi-mcp/server.py"],
      "env": {
        "MOTORAPI_KEY": "your-api-key-here"
      }
    }
  }
}

更新配置后重新启动Claude Desktop。

查询示例

连接后，您可以问Claude：

  • “查找车辆信息以注册AB12345”
  • “获取VIN WBA12345678901234的环境数据”
  • “显示注册设备列表XY98765”
  • “查看我的MotorAPI使用统计数据”

API终点

服务器集成了以下MotorAPI.dk端点：

  • GET /vehicles/{reg-no-or-vin} -车辆详细信息
  • GET /vehicles/{reg-no-or-vin}/environment -环境数据
  • GET /vehicles/{reg-no-or-vin}/equipment -设备清单
  • GET /usage -API使用情况统计

云部署

部署以渲染

手动渲染部署

  1. 将此存储库分叉到您的GitHub帐户
  2. 注册/登录 渲染
  3. 创建新 网络服务
  4. 连接您的GitHub存储库
  5. 配置服务：
    • 名称：motorapi-mcp（或您的首选名称）
    • 运行时：Python 3
    • 生成命令: pip install -r requirements.txt
    • 启动命令: python server.py
  6. 添加环境变量：
    • 钥匙: MOTORAPI_KEY
    • 价值：您的MotorAPI.dk API密钥
  7. 点击 创建Web服务

使用render.yaml（基础结构即代码）

存储库包括 render.yaml 用于自动部署的文件：

  1. 首选 渲染仪表板
  2. 点击 新 → 蓝图
  3. 连接您的GitHub存储库
  4. 渲染将自动检测 render.yaml
  5. 设置 MOTORAPI_KEY 环境变量
  6. 点击 应用

备注：服务器只使用纯Python依赖项（不需要Rust编译），确保在Render的免费层上快速可靠地构建。

部署到铁路

  1. 单击上面的按钮或在Railway上创建新项目
  2. 连接您的GitHub存储库
  3. 设置 MOTORAPI_KEY 环境变量
  4. 部署！

发展

项目结构

motorapi-mcp/
├── server.py           # Main MCP server implementation
├── requirements.txt    # Python dependencies
├── README.md          # This file
├── pyproject.toml     # Python project configuration
├── railway.json       # Railway deployment configuration
├── render.yaml        # Render deployment configuration
└── .gitignore         # Git ignore rules

测试

使用MCP检查器测试服务器：

pip install mcp-inspector
mcp-inspector python server.py

错误处理

服务器包括以下正确的错误处理：

  • 404未找到（车辆不存在）
  • 网络错误
  • API身份验证错误
  • 超时错误

错误以JSON对象的形式返回，并带有 error 现场。

依赖项

这个项目只使用纯Python包，不需要Rust编译：

  • 主控程序 （>=1.0.0）-模型上下文协议SDK
  • httpx （>=0.27.0）-现代异步HTTP客户端

这确保了快速构建和与所有云平台的兼容性。

许可证

MIT许可证-可根据需要自由使用和修改。

资源

支持

对于问题或疑问：

  • 打开一个问题 GitHub
  • 有关API相关问题，请查看MotorAPI.dk文档

相关 MCP