EnCarAPI - Korean & Chinese used cars

EnCarAPI MCP 服务：面向 AI 助手的韩国和中国二手车数据

Model Context Protocol 服务，适用于 EnCarAPI。让 Claude、Cursor、ChatGPT 和其他 MCP 客户端能够搜索 韩国的实时二手车信息（Encar、KB Chachacha、K Car）和中国的实时二手车信息 （Dongchedi、Che168），并获取完整详情、检测报告和事故记录。

需要 API 密钥。 前往 encarapi.com 获取（可试用 5 天）。 中国数据可使用 ChinaCarAPI 密钥，或带有中国数据附加项的 EnCarAPI 密钥。 ChinaCarAPI 客户请参阅致 ChinaCarAPI 客户。

工具

工具	功能
search_korean_cars	搜索韩国车辆信息（品牌、车型、年份、价格，单位为 10,000 韩元、里程、燃料、无事故、卖家地区和城市、来源：encar / kbc / kcar / all；lang：en、ru 或 de，分别表示英语、俄语或德语值）
search_korean_excavators	搜索韩国二手挖掘机（制造商、型号、工作小时数、重量等级、地区；需要 Business/Scale 密钥）
search_korean_trucks	搜索韩国卡车、公交车和特种车辆（车身类型、载重量，单位为吨、用途、地区；需要 Business/Scale 密钥）
find_korean_car_by_vin	查找某个 VIN 对应的所有 Encar / K Car 车辆信息，包括已下架的信息（需要 Business/Scale 密钥）
get_korean_truck	获取一辆卡车的完整记录：详情、检测报告、货箱、VIN 和车牌（需要 Business/Scale 密钥）
get_korean_car	获取一条车辆信息的完整详情（规格、选装配置、照片、价格历史、卖家；lang：en、ru 或 de）
get_korean_inspection	韩国官方检测报告
get_korean_accident_record	保险事故历史和所有权变更记录
find_korean_models	跨品牌自动补全车型名称
korean_filter_values	有效的筛选值
search_chinese_cars	搜索中国车辆信息（品牌、车型、车型年份、注册年份、价格，单位为人民币、里程、动力、城市、燃料、来源、可出口状态；lang：en、zh 或 ru）
get_chinese_car	获取一条中国车辆信息的完整记录（lang：en、zh 或 ru）
get_chinese_car_by_url	通过 Che168 / Dongchedi 车辆信息链接获取完整记录（桌面版、手机版或 App 链接；lang：en、zh 或 ru）
get_chinese_inspection	中国检测报告（事故、水淹、火灾、电动汽车电池）
get_chinese_specs	Che168 车型配置的 Autohome 规格表（排量、kW、hp、扭矩、排放标准、重量、电动汽车电池）
chinese_filter_values	有效的品牌、燃料类型、城市和来源，以及车辆信息数量
chinese_models	某品牌的车型及其车辆信息数量

中文 lang：zh 返回原始中文值；ru 返回固定字段（燃料、变速箱、驱动形式、颜色、卖家类型、车况、车辆类别）的俄语值、城市名称和配置名称； 品牌、车型和配置名称仍使用拉丁字母。

所有工具均为只读。

选项 1：托管服务（无需安装）

将此 URL 添加为远程 MCP 服务：

https://mcp.encarapi.com/mcp

对于支持 OAuth 的客户端，只需提供此 URL。首次使用时会打开浏览器窗口，你只需粘贴一次 EnCarAPI 密钥，客户端即可连接：

• Claude（claude.ai、桌面端、移动端）：Settings - Connectors - Add custom connector，粘贴 URL
• ChatGPT（开发者模式）：Settings - Connectors - 创建一个使用该 URL 的连接器
• Cursor：在 .cursor/mcp.json 中填写 {"mcpServers": {"encarapi": {"url": "https://mcp.encarapi.com/mcp"}}}
• VS Code："MCP: Add Server" - HTTP - 粘贴 URL
• Claude Code：

claude mcp add --transport http encarapi https://mcp.encarapi.com/mcp

密钥只会验证一次，不会存储在服务端：它会加密到客户端接收的令牌中。如需断开连接，请在客户端中移除此服务；如需在所有位置撤销访问权限，请前往 encarapi.com 轮换密钥。

备选方案：自行发送密钥

不支持 OAuth 的客户端、脚本和网关可以直接发送密钥：

https://mcp.encarapi.com/mcp
Authorization: Bearer YOUR_ENCARAPI_KEY

Claude Code：

claude mcp add --transport http encarapi https://mcp.encarapi.com/mcp \
  --header "Authorization: Bearer YOUR_ENCARAPI_KEY"

x-api-key: YOUR_ENCARAPI_KEY 请求头同样可用。只接受 URL 且不支持 OAuth 的客户端可以使用 https://mcp.encarapi.com/mcp?key=YOUR_ENCARAPI_KEY（优先使用请求头，因为 URL 可能会出现在日志中）。单独的 ChinaCarAPI 密钥应放入 x-china-key 请求头，或浏览器表单的第二个字段。

ChinaCarAPI 客户

ChinaCarAPI 有自己的地址：

https://mcp.chinacarapi.com/mcp

按上述方法将其添加为远程 MCP 服务。首次使用时会打开浏览器窗口，粘贴一次 ChinaCarAPI 密钥即可。表单会自动识别密钥类型，因此 EnCarAPI 密钥也可在此使用；同时拥有两种密钥的客户可将 EnCarAPI 密钥填入可选的第二个字段。

• Claude（claude.ai、桌面端、移动端）：Settings - Connectors - Add custom connector，粘贴 URL
• Cursor：将 {"mcpServers": {"chinacarapi": {"url": "https://mcp.chinacarapi.com/mcp"}}} 填入 .cursor/mcp.json
• Claude Code：

claude mcp add --transport http chinacarapi https://mcp.chinacarapi.com/mcp

在此地址上，中文工具会优先列出。先使用 chinese_filter_values 获取有效的品牌、燃料类型和城市（city 筛选器需要使用列表中的准确 value）。

如果不使用浏览器登录，请通过请求头发送密钥。在 mcp.chinacarapi.com 上，Authorization: Bearer 或 x-api-key 中的密钥会被视为 ChinaCarAPI 密钥：

claude mcp add --transport http chinacarapi https://mcp.chinacarapi.com/mcp \
  --header "Authorization: Bearer YOUR_CHINACARAPI_KEY"

x-china-key: YOUR_CHINACARAPI_KEY 可用于两个地址；此时 Authorization 可携带用于韩国工具的 EnCarAPI 密钥。

本地运行（npx）时，设置 CHINACARAPI_KEY，而非 ENCARAPI_KEY：

claude mcp add chinacarapi -e CHINACARAPI_KEY=YOUR_CHINACARAPI_KEY -- npx -y encarapi-mcp

选项 2：本地运行（npx）

Claude Desktop（claude_desktop_config.json）、Cursor（.cursor/mcp.json）和大多数其他客户端：

{
  "mcpServers": {
    "encarapi": {
      "command": "npx",
      "args": ["-y", "encarapi-mcp"],
      "env": {
        "ENCARAPI_KEY": "YOUR_ENCARAPI_KEY"
      }
    }
  }
}

Claude Code：

claude mcp add encarapi -e ENCARAPI_KEY=YOUR_ENCARAPI_KEY -- npx -y encarapi-mcp

可选：CHINACARAPI_KEY，用于单独的 ChinaCarAPI 密钥。

提示词示例

• “查找 2022 年或更新、无事故、价格低于 5,000 万韩元的 Genesis GV80，并比较里程数。”
• “显示 Encar 上架车辆 41000001 的检测报告和事故记录。”
• “目前中国最便宜、可供出口的 BYD Seal 在售车辆有哪些？”

自托管 HTTP 端点

docker build -t encarapi-mcp .
docker run -p 3000:3000 encarapi-mcp     # POST /mcp, GET /health

无状态：每个请求都携带自己的密钥，不会存储任何内容。

要启用 OAuth 流程（“仅通过 URL 连接”），请设置两个环境变量：

变量	含义
MCP_OAUTH_SECRET	至少 32 个随机字符，例如 openssl rand -base64 48。启用 OAuth；未设置时，服务仅接受客户端发送的密钥。
MCP_PUBLIC_URL	服务的公共源，例如 https://mcp.example.com（默认值为 https://mcp.encarapi.com）。令牌绑定到 <MCP_PUBLIC_URL>/mcp。
MCP_PUBLIC_URLS	可选，多个以逗号分隔的公共源，例如 https://mcp.encarapi.com,https://mcp.chinacarapi.com。此变量会取代 MCP_PUBLIC_URL。Host 请求头用于选择源（未知主机将使用第一个）；每个源都有自己的签发方和品牌信息，其令牌不会被其他源接受。主机名中包含 chinacarapi. 的源将使用 ChinaCarAPI 品牌信息。

docker run -p 3000:3000 -e MCP_OAUTH_SECRET="$(openssl rand -base64 48)" \
  -e MCP_PUBLIC_URL=https://mcp.example.com encarapi-mcp

这会添加 /.well-known/oauth-protected-resource、/.well-known/oauth-authorization-server、 /register、/authorize 和 /token（支持 PKCE 的 OAuth 2.1、动态客户端注册）。 服务仍然不使用数据库：客户端 ID、授权码和令牌都是加密的自包含值（AES-256-GCM），其中携带了密钥。由此产生的影响：

• 更改 MCP_OAUTH_SECRET 会让所有 OAuth 客户端退出登录（需通过浏览器重新连接）。
• 访问令牌有效期为 1 小时，刷新令牌有效期为 90 天，且每次使用后都会被替换。
• 授权码和已替换刷新令牌的单次使用情况会在内存中跟踪，因此只能尽力保证：服务重启后记录会丢失，多个实例之间也不会共享。
• 无法在服务端撤销单个令牌。轮换 EnCarAPI 密钥即可切断所有访问。

链接

• EnCarAPI：encarapi.com
• ChinaCarAPI：chinacarapi.com
• SDK：Node.js、Python

EnCarAPI 是一项独立服务，与 Encar、KB Chachacha、K Car、Dongchedi 或 Che168 均无关联。

许可证

MIT