CarKeeper ChatGPT MCP 集成

此项目将 ChatGPT 连接到实时的 CarKeeper 报告引擎。

提供的功能

• check_vehicle — 针对一个车牌号运行真实的 CarKeeper 引擎。

• analyse_purchase — 运行完整的 CarKeeper 购车报告，包含价格、广告文本和可选图片。

• compare_vehicles — 对 2–5 辆汽车运行 CarKeeper，并根据实时报告返回的 Buyer Score 对它们进行排名。

• start_full_report_checkout — 可选/私有工具，用于创建现有的 £9.99 CarKeeper WooCommerce 结账。

• get_report — 可选/私有工具，用于读取已付费报告的状态/文本。

商务工具默认处于禁用状态，因为当前公共 Plugin Directory 表单声明不支持数字商品交易。它们仍可在开发者模式中启用，用于私有测试。

Related MCP server: Vehicle Database MCP Server

架构

ChatGPT -> MCP 服务器 -> 受保护的 CarKeeper Render 端点 -> DVLA/DVSA/Check Car Details/网页/OpenAI

可选私有购买路径： ChatGPT -> MCP 服务器 -> WordPress REST 桥接器 -> 现有 WooCommerce 结账/报告流程

1. 修补 Render 报告引擎

使用随附的 carkeeper-report-engine-plugin 后端版本。它保持 /generate-report 不变以用于网站，并新增：

POST /plugin/generate-report

此路由要求：

Authorization: Bearer <CARKEEPER_PLUGIN_TOKEN>

将 CARKEEPER_PLUGIN_TOKEN 添加到 Render 服务环境中。

2. 配置此 MCP 服务器

将 .env.example 复制为 .env，并设置相同的 CARKEEPER_PLUGIN_TOKEN 值。

对于公开/插件测试，请保留：

CARKEEPER_ENABLE_COMMERCE_TOOLS=false

3. 安装并运行

npm install
npm start

MCP 端点为：

http://localhost:8787/mcp

4. 本地测试

npx @modelcontextprotocol/inspector@latest

使用 Streamable HTTP 将 Inspector 连接到 http://localhost:8787/mcp。

5. 连接到 ChatGPT 开发者模式

使用 ngrok 等 HTTPS 隧道暴露 8787 端口，并使用：

https://YOUR-TUNNEL/mcp

作为应用的 MCP URL。

可选：现有的 £9.99 结账流程

将 carkeeper-chatgpt-api.php 作为小型 WordPress 插件安装。在 WordPress 配置的安全位置添加以下常量：

define('CK_CHATGPT_API_TOKEN', 'a-long-random-secret');

在 MCP 服务器上设置与 CARKEEPER_WP_API_TOKEN 相同的值，并设置：

CARKEEPER_ENABLE_COMMERCE_TOOLS=true

仅用于私有开发者模式测试。

该桥接器使用 CarKeeper 现有的报告创建、结账令牌恢复、£9.99 WooCommerce 产品和付费报告存储，而不是创建“更多支付系统”。

安全

切勿提交 .env、OpenAI 密钥、Check Car Details 密钥、DVLA 密钥或共享插件令牌。请为两个共享令牌生成长度长、随机的密码。