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

1. 添加环境变量：

- 钥匙: MOTORAPI_KEY - 价值：您的MotorAPI.dk API密钥

1. 点击 创建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许可证-可根据需要自由使用和修改。

资源

• MotorAPI.dk文档
• 模型上下文协议
• MCP Python SDK

支持

对于问题或疑问：

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