cardossier-market-api

CarDossier 波兰市场 API — MCP 服务

mcp-name: io.github.Joyall-au/cardossier-market-api

一个 MCP（Model Context Protocol）服务，让 AI 助手（Claude、Cursor、Windsurf 以及任何兼容 MCP 的 Agent）通过 CarDossier Market API 实时获取波兰二手车市场数据。

功能

此服务提供 5 种工具，AI Agent 可以调用它们来回答以下问题：

• “2019 年款 Toyota Corolla 现在在波兰值多少钱？”
• “过去 6 个月，柴油 BMW 的价格是在涨还是在跌？”
• “二手 Volkswagen Golf 在波兰卖得有多快？”
• “2020 年款 Audi A4 在 Mazowieckie 还是 Śląskie 更便宜？”
• “2018 年款 Ford Focus 配备自动变速箱会贵多少？”

可用工具

工具	说明	点数
get_market_valuation	任意品牌、车型和年份的平均价、中位数、第 25 百分位数和第 75 百分位数	8
get_price_history	最长 24 个月的月度价格趋势	10
get_market_liquidity	预估在售天数（车辆售出的速度）	6
get_valuation_factors	变速箱类型、燃油类型和进口状态对价格的影响	12
get_regional_pricing	波兰全部 16 个省的价格比较	8

数据来源：来自波兰领先汽车交易平台的 140 多万条有效挂牌信息，每日更新。

车辆名称会自动解析——VW Golf、BMW 3 Series / 320d、Mercedes C-Class、Audi A4、XC60 均可使用；响应会准确显示汇总了哪些交易平台车型。调用失败会自动退还点数。

🚀 无需密钥即可试用

该 API 每个 IP 每天提供 5 次无需密钥的演示调用，使用完整的真实数据，因此安装后即可使用此服务：

pip install cardossier-mcp-server
cardossier-mcp

如需更多配额，可免费注册——通过电子邮件 OTP 获取 50 点数，无需信用卡——然后设置 CARDOSSIER_API_KEY。

前置条件

• Python 3.9+
• 可选：CarDossier API 密钥——免费注册即可获得 50 个免费点数（无需信用卡），也可购买付费套餐，起价为 $49，可获得 5,000 点数

安装

# From PyPI (recommended)
pip install cardossier-mcp-server

# Or from source
git clone https://github.com/Joyall-au/cardossier-mcp-server.git
cd cardossier-mcp-server
pip install mcp requests

使用方法

1.（可选）设置 API 密钥

export CARDOSSIER_API_KEY="your_api_key_here"   # omit to use the keyless demo tier

2. 运行服务

cardossier-mcp
# or from a source checkout: python mcp_server.py

3. 连接到 Claude Desktop

将以下内容添加到 Claude Desktop 配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "cardossier": {
      "command": "cardossier-mcp",
      "env": {
        "CARDOSSIER_API_KEY": "your_api_key_here"
      }
    }
  }
}

4. 连接到 Cursor 或 Windsurf

添加到 MCP 设置中：

{
  "cardossier": {
    "command": "cardossier-mcp",
    "env": {
      "CARDOSSIER_API_KEY": "your_api_key_here"
    }
  }
}

交互示例

连接后，你可以向 AI 助手提问：

“2020 年款柴油 BMW 3 Series 目前在波兰的市场价值是多少？”

Agent 会调用 get_market_valuation，参数为 make=BMW, model=3 Series, year=2020, fuel_type=diesel，并返回价格的统计分布。

“告诉我过去一年 Toyota Corolla 的价格变化情况。”

Agent 会调用 get_price_history，参数为 months=12，并返回月度价格趋势。

“比较波兰各地区的二手 Skoda Octavia 价格。”

Agent 会调用 get_regional_pricing，并返回按省划分的价格明细。

API 参考

完整 API 文档：car-dossier.com/en/api/docs
OpenAPI 3.1 规范：car-dossier.com/openapi.yaml
常见问题：car-dossier.com/en/api/faq/

定价

CarDossier Market API 使用按需付费的积分系统。积分永不过期。

免费试用： 在 car-dossier.com/en/api/pricing 注册，即可立即获得 50 个免费积分，无需信用卡。足以进行约 6 次市场估值调用。

套餐	价格	积分	约估值调用次数
免费试用	$0	50	约 6
入门版	$49	5,000	约 625
成长版	$129	15,000	约 1,875
专业版	$299	40,000	约 5,000
商务版	$699	100,000	约 12,500

免费开始——获取 50 个积分 →

许可证

MIT 许可证——详情请参阅 LICENSE。

关于

由 CarDossier 构建——波兰领先的车辆历史和市场数据平台。