AI导哈

汽车市场智能分析平台

提供45个交互式汽车市场智能仪表板和7个AI聊天演示，支持在AI助手内使用、独立网页展示、嵌入式iframe小部件或对话式AI聊天界面。

  • by MarketcheckHub
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 MarketcheckHub/marketcheck-mcp-apps

使用说明

MarketCheck API和MCP应用程序

45个交互式汽车市场情报仪表板+7个AI聊天演示 --可用作人工智能助手内的MCP UI应用程序、独立的网络展示、可嵌入的iframe小部件或对话式人工智能聊天界面。

由...驱动 市场检查 实时汽车数据——VIN解码、ML价格预测、活跃/已售库存和汇总市场分析。聊天演示通过7个不同的聊天SDK展示了相同的API功能。

现场演示： apps.marketcheck.com

4种使用方法

模式 描述 需要授权
演示 浏览所有45个具有真实样本数据的应用程序 无
实时数据 输入MarketCheck API密钥以获取真实市场数据 API密钥（在应用程序UI中输入）
嵌入 通过iframe在您的网站/门户中嵌入应用程序 OAuth访问令牌（安全，6小时TTL）
MCP/AI 在Claude、VS Code Copilot、Goose和其他MCP主机内部使用 API Key（服务器端env-var）

没有API密钥？ 免费注册developers.marketcheck.com

快速开始

现场演示（托管）

访问 apps.marketcheck.com --所有45个应用程序都以演示模式提供。在设置档中输入API键以切换到实时数据。

自托管

# Install dependencies
npm install

# Build everything (gallery + 45 apps + server)
npm run build

# Start the server
npm run serve

然后打开：

  • 画廊： http://localhost:3001/--浏览全部45个应用程序
  • MCP端点： http://localhost:3001/mcp--用于AI助手连接器
  • 任何应用程序直接： http://localhost:3001/apps/{应用程序名称}/dist/index.html

演示模式（无需服务器）

直接在浏览器中打开任何构建的HTML文件——所有应用程序都有模拟数据：

open packages/apps/vin-market-report/dist/index.html
open packages/apps/deal-evaluator/dist/index.html
open packages/apps/car-search-app/dist/index.html

作为MCP服务器连接

MCP服务器URL

如果托管在 apps.marketcheck.com:

https://apps.marketcheck.com/mcp

MCP模式的身份验证

有 两种方式 进行身份验证：

选项1：MCP URL中的API密钥（建议个人用户使用）

将MarketCheck API密钥作为查询参数传递到MCP URL上：

https://apps.marketcheck.com/mcp?api_key=YOUR_API_KEY

这允许每个用户提供自己的密钥。不需要服务器配置。

选项2：服务器端环境变量（建议用于共享/托管部署）

集 MARKETCHECK_API_KEY 在服务器上。所有连接的MCP客户端都会自动共享此密钥——用户不需要提供密钥。

MARKETCHECK_API_KEY=your_api_key npm run serve

优先级顺序： 如果客户提供 ?api_key= 在URL中，它优先于该请求的服务器环境变量。如果没有提供URL键，则使用env-var作为回退。

没有API密钥？ 免费注册developers.marketcheck.com

在克劳德建立

  1. 首选 设置→ 连接器→ 添加自定义连接器
  2. 输入MCP服务器URL：
    • 使用您自己的密钥： https://apps.marketcheck.com/mcp?api_key=YOUR_API_KEY
    • 无密钥（使用服务器默认值）： https://apps.marketcheck.com/mcp
  3. 开始新的聊天，让克劳德使用任何工具（例如“评估这笔交易：VIN 5TDJSKFC2NS055758”）

自定义连接器需要付费的Claude计划（Pro、Max或Team）。

在Claude Code/VS Code/其他MCP客户端中设置

添加到MCP客户端配置中：

{
  "mcpServers": {
    "marketcheck-apps": {
      "url": "https://apps.marketcheck.com/mcp?api_key=YOUR_API_KEY"
    }
  }
}

或者没有个人密钥（服务器提供自己的密钥）：

{
  "mcpServers": {
    "marketcheck-apps": {
      "url": "https://apps.marketcheck.com/mcp"
    }
  }
}

这与MarketCheck MCP数据服务器有何不同？

MarketCheck优惠 两个独立的MCP服务器:

服务器 用途 工具
MarketCheck MCP数据服务器 原始API访问-搜索、解码、预测等。 search_active_cars, decode_vin_neovin, predict_price_with_comparables等等。
MarketCheck MCP应用程序 （此项目） 具有可视化UI的交互式仪表板 evaluate-deal, estimate-trade-in, generate-vin-market-report等等。

主要区别：

  • 这 数据服务器 返回原始JSON数据——AI模型处理并呈现它
  • 这 应用程序服务器 返回在MCP主机的UI面板中呈现的交互式HTML仪表板——用户可以直接与图表、表格和过滤器进行交互
  • 应用服务器 调用相同的MarketCheck API 在引擎盖下，但将它们包裹在丰富的视觉界面中
  • 您可以使用 两台服务器同时运行 --它们有不同的工具名称，并且不冲突

您不需要数据服务器来使用应用服务器。 每个人都是独立的。应用服务器有自己的服务器端API密钥，并进行自己的API调用。

全部52个应用程序

消费者（9个应用程序）

应用程序 工具名称 描述
VIN市场报告 generate-vin-market-report 完整的基于VIN的市场情报报告——可嵌入小部件
汽车搜索与比较 search-cars, compare-cars 使用滤镜、照片卡和并排比较进行视觉汽车购物
汽车搜索 -- 使用SERP、车辆详细信息和自然语言搜索进行全面搜索
交易评估员 evaluate-deal 使用量规、谈判工具包和替代方案购买/谈判/通过裁决
激励调整交易评估员 evaluate-incentive-deal 折扣和APR节省后的实际自付成本
折价估算器 estimate-trade-in 具有卖出补偿证据的即时三层折价交易
二手车市场指数 get-market-index 跟踪二手车价格的股票行情式仪表板⚠️ 企业API
OEM激励探索者 oem-incentives-explorer 按ZIP分类的现金返还、年利率和租赁交易
激励交易查找器 find-incentive-deals 按预算而非品牌搜索所有OEM激励措施

经销商（5个应用程序）

应用程序 工具名称 描述
批量定价仪表板 scan-lot-pricing 完整的批次库存，包括市场价格差距、老化热图、库存热单
库存情报 stocking-intelligence 需求热图、购买/避免清单、VIN检查器
定价透明度报告 generate-pricing-report 经销商向买家提供的可共享市场报告
经销商库存匹配评分器 score-dealer-fit 哪些汽车符合你的销售DNA？ML获得收购
经销商征服分析器 analyze-dealer-conquest 寻找竞争对手最畅销的商品

估价师（4个应用程序）

应用程序 工具名称 描述
估价师工作台 appraiser-workbench 整车估值工作室
可比数据浏览器 comparables-explorer 价格分布和市场定位
折旧分析仪 depreciation-analyzer 跟踪车辆如何随着时间的推移而失去价值
市场趋势仪表板 market-trends-dashboard 汽车市场的脉搏

经销商组（3个应用程序）

应用程序 工具名称 描述
大队作战中心 group-operations-center 每家店，一个屏幕
库存平衡器 inventory-balancer 把合适的车开到合适的商店
位置基准 location-benchmarking 对您的位置进行排名和比较

贷款人（4个应用程序）

应用程序 工具名称 描述
承保决策支持 evaluate-loan-application 基于LTV预测的单笔贷款抵押品估值
投资组合风险监控 portfolio-risk-monitor 跟踪整个贷款账簿中的抵押品健康状况
贷款人投资组合压力测试 stress-test-portfolio 如果贷款账簿上的折旧情况如何
EV抵押品风险监控 ev-collateral-risk EV与ICE折旧风险跟踪

分析师（3个应用程序）

应用程序 工具名称 描述
收益信号仪表板 earnings-signal-dashboard 自动收报机收益前渠道检查
监视列表监视器 watchlist-monitor 晨间信号扫描您的投资组合
经销商组记分卡 dealer-group-scorecard 基准公共经销商集团

保险公司（2个应用程序）

应用程序 工具名称 描述
索赔估价工作台 claims-valuation 根据市场证据确定全损
保险费基准 benchmark-insurance-premiums 分段级重置成本和风险分析

制造商（2个应用程序）

应用程序 工具名称 描述
品牌指挥中心 brand-command-center 你的品牌与竞争对手
区域需求分配器 regional-demand-allocator 在需求最热的地方分配库存

拍卖行（2个应用程序）

应用程序 工具名称 描述
拍卖车道规划师 auction-lane-planner 规划车道、定价货物、目标买家
拍卖套利查找器 find-auction-arbitrage 批发与零售价差——寻找盈利机会

批发商（1个应用程序）

应用程序 工具名称 描述
批发车辆路由器 route-wholesale-vehicles 粘贴VIN，获取经销商匹配排名

跨领域（4个应用程序）

应用程序 工具名称 描述
电动汽车市场监测 ev-market-monitor 一个仪表板上的电动汽车过渡
VIN历史侦探 trace-vin-history 完整的上市时间线——经销商跳跃、价格变化、危险信号
市场异常检测器 detect-market-anomalies 查找定价过低的车辆和定价异常值
英国市场趋势 get-uk-market-trends 宏观英国汽车市场情报

英国消费者（1个应用程序）

应用程序 工具名称 描述
英国市场探索者 search-uk-cars 以英镑搜索和比较英国汽车列表

英国经销商（1个应用程序）

应用程序 工具名称 描述
英国经销商定价 scan-uk-lot-pricing 英国批次库存按市场定价

自动媒体（1个应用程序）

应用程序 工具名称 描述
汽车记者简报会 generate-market-briefing 一页市场简报，包含可引用的数据点

车队管理器（1个应用程序）

应用程序 工具名称 描述
车队生命周期经理 manage-fleet-lifecycle 车队价值、折旧和更换计划

租赁/订阅（1个应用程序）

应用程序 工具名称 描述
租赁车队估值器 value-rental-fleet 根据轮换时间调整里程的车队估值

贷方销售（1个应用程序）

应用程序 工具名称 描述
领土管道 territory-pipeline 查找需要平面图的经销商

聊天演示（7个应用程序）

每个聊天演示都使用不同的SDK，通过对话式人工智能界面展示MarketCheck API功能：

应用程序 SDK 语言 描述
AI汽车顾问 Vercel AI 开发工具包 Types/Next.js 参考聊天 useChat 钩子、流媒体和工具可视化
仪表板副驾驶 副驾驶套件 React/Next.js 现有仪表板UI上的AI副驾驶覆盖
MarketCheck聊天 助理ui React/Next.js 自定义品牌黑色主题，带有丰富的工具结果卡
多平台机器人 聊天SDK TypeScript 单个代码库部署到Slack、Discord、Telegram、Teams
市场分析师 链聊 Python MCP原生聊天，内置工具执行可视化
快速市场检查 溪流 Python 数据团队的轻量级聊天
AI代理浏览器 LangChain Types/Next.js 具有可见推理链的LangGraph ReAct代理

运行聊天演示

TypeScript应用程序（Vercel AI SDK、CopilotKit、助手ui、LangChain）：

cd packages/chat/vercel-ai-chat   # or copilotkit-chat, assistant-ui-chat, langchain-agent-chat
cp .env.local.example .env.local  # Add your ANTHROPIC_API_KEY and MARKETCHECK_API_KEY
npm install
npm run dev

Python应用程序（Chainlit、Streamlit）：

cd packages/chat/chainlit-chat    # or streamlit-chat
cp .env.example .env              # Add your keys
pip install -r requirements.txt

# Chainlit:
chainlit run app.py -w

# Streamlit:
streamlit run app.py

聊天SDK机器人（Slack/Discord/Telegram）：

cd packages/chat/chat-sdk-bot
cp .env.example .env              # Add API keys + platform bot tokens
npm install
npm run dev

API访问模式

应用程序支持三种数据访问路径，按顺序尝试：

1.MCP模式（AI助手）

在MCP主机（Claude、VS Code等）内运行时，应用程序会调用 _safeApp.callServerTool() 该路由通过MCP服务器。服务器使用其 MARKETCHECK_API_KEY env-var——用户不提供密钥。

2.直接API模式（网络/嵌入）

当使用API密钥在浏览器中加载时，应用程序会调用MarketCheck API 直接 从浏览器：

Browser → https://api.marketcheck.com/v2/search/car/active?api_key=KEY&...

不需要代理或服务器。MarketCheck API支持CORS(Access-Control-Allow-Origin: *).

使用：在应用程序的设置设备中输入您的API键，或将其作为URL参数传递：

https://apps.marketcheck.com/apps/deal-evaluator/dist/index.html?api_key=YOUR_KEY

3.演示模式（无身份验证）

如果没有API密钥可用，应用程序将显示真实的模拟数据。每个应用程序都可以完全离线工作。

在门户中嵌入应用程序

将任何应用程序作为iframe嵌入您的网站。

选项A:API密钥（简单，内部使用）

<iframe
  src="https://apps.marketcheck.com/apps/deal-evaluator/dist/index.html?api_key=YOUR_KEY&embed=true&vin=5TDJSKFC2NS055758"
  width="100%" height="700"
  style="border:none;border-radius:8px;"
></iframe>

选项B：OAuth令牌（建议用于生产）

将API密钥+客户端机密交换为短时间令牌（服务器端）：

curl -X POST https://api.marketcheck.com/oauth2/token \
  -H "Content-Type: application/json" \
  -d '{"grant_type":"client_credentials","client_id":"YOUR_API_KEY","client_secret":"YOUR_SECRET"}'

然后嵌入令牌：

<iframe
  src="https://apps.marketcheck.com/apps/deal-evaluator/dist/index.html?access_token=TOKEN&embed=true&vin=5TDJSKFC2NS055758"
  width="100%" height="700"
  style="border:none;border-radius:8px;"
></iframe>

URL参数

参数 描述
access_token OAuth令牌（安全，6小时TTL）
api_key API密钥（个人/内部使用）
embed=true 隐藏镀铬，全出血布局，自动执行
vin 预先填充VIN字段
zip 预填充邮政编码
make, model 预先填充车辆选择
miles 预填充里程
state 预填充状态
compact=true 小部件模式（仅限VIN市场报告）

建筑

marketcheck-api-mcp-apps/
├── package.json                    # Monorepo root (npm workspaces)
├── packages/
│   ├── shared/                     # Shared utilities & types
│   │   └── src/
│   │       ├── types.ts            # Common TypeScript types
│   │       ├── formatters.ts       # Currency, percent, signal classifiers
│   │       ├── index-calculator.ts # Index computation, depreciation, D/S ratio
│   │       └── marketcheck-client.ts # Typed MarketCheck API wrapper (server-side)
│   ├── server/                     # MCP server (44 tools)
│   │   └── src/
│   │       ├── index.ts            # Express + MCP server
│   │       ├── register-app.ts     # Helper to register tool + UI resource pairs
│   │       ├── proxy.ts            # CORS proxy for legacy/fallback mode
│   │       └── tools/              # 44 tool handler files
│   ├── gallery/                    # Web gallery UI
│   ├── apps/                       # 45 app UI folders
│   │   ├── vin-market-report/
│   │   │   ├── src/main.ts         # Full app UI + direct API client
│   │   │   └── dist/index.html     # Built single-file HTML bundle
│   │   └── ... (44 more)
│   └── chat/                       # 7 AI chat demo apps
│       ├── shared/                 # Shared tool definitions & prompts
│       ├── vercel-ai-chat/         # Next.js + Vercel AI SDK
│       ├── copilotkit-chat/        # Next.js + CopilotKit
│       ├── assistant-ui-chat/      # Next.js + assistant-ui
│       ├── chat-sdk-bot/           # Multi-platform bot (Slack/Discord/Telegram)
│       ├── chainlit-chat/          # Python + Chainlit
│       ├── streamlit-chat/         # Python + Streamlit
│       └── langchain-agent-chat/   # Next.js + LangGraph
├── public/                         # Vercel deployment output
├── static/screenshots/             # App screenshots for gallery
└── scripts/                        # Build & migration utilities

运作原理

  1. 这 MCP服务器 注册44个工具，每个工具都有一个 _meta.ui.resourceUri 指向a ui:// 资源
  2. 当MCP主机（Claude、VS Code等）调用工具时，它也会获取UI资源—— 单文件HTML捆绑包
  3. 该应用程序以 沙盒iframe 主机内部
  4. 应用程序调用 app.callServerTool() 数据和 app.updateModelContext() 将结果推回LLM
  5. 在网络模式下，应用程序调用 直接MarketCheck API 从浏览器（不需要代理）
  6. 所有应用程序包括 模拟数据回退 用于演示模式

技术栈

  • 服务器： @modelcontextprotocol/sdk + @modelcontextprotocol/ext-apps +快递
  • UI： Vanilla TypeScript+Canvas 2D API（无图表库）
  • 构建： 快+ vite-plugin-singlefile → 每个应用程序一个HTML文件
  • 数据： MarketCheck API（12个终点：VIN解码、价格预测、活跃/已售出搜索、上市历史、已售出总结、OEM激励措施、经销商/车辆排名、英国市场）

MarketCheck API终点

端点 路径 目的
VIN解码 GET /v2/decode/car/neovin/{vin}/specs VIN与整车规格
价格预测 GET /v2/predict/car/us/marketcheck_price/comparables ML价格预测+可比性
搜索活动 GET /v2/search/car/active 带过滤器的当前经销商列表
最近搜索 GET /v2/search/car/recents 最近出售/过期的房源
汽车历史 GET /v2/history/car/{vin} 列出VIN的时间线
销售摘要 GET /api/v1/sold-vehicles/summary 综合市场分析
OEM激励措施 GET /v2/incentives/by-zip ZIP的制造商激励措施
经销商排名 GET /v2/rank/dealers 经销商车辆匹配评分
车辆排名 GET /v2/rank/vehicles 车辆经销商匹配度评分
英国活跃 GET /v2/search/car/uk/active 英国市场活跃上市
英国最近 GET /v2/search/car/uk/recents 英国市场近期上市

部署

托管于apps.marketcheck.com

生产实例托管在 apps.marketcheck.com.

  • 画廊： https://apps.marketcheck.com/
  • MCP端点： https://apps.marketcheck.com/mcp
  • 个人应用程序： https://apps.marketcheck.com/apps/{app-name}/dist/index.html
  • 健康检查： https://apps.marketcheck.com/health

环境变量

MARKETCHECK_API_KEY=your_api_key    # Required for MCP mode
PORT=3001                           # Server port (default 3001)

自助托管选项

Vercel（建议用于无服务器）：

npx vercel --prod

Docker/云运行/铁路/渲染/Fly.io：

npm install && npm run build
PORT=3001 MARKETCHECK_API_KEY=your_key npm run serve

MCP主机兼容性

MCP应用程序受以下支持：

发展

构建所有应用程序

npm run build

构建单个应用程序

cd packages/apps/deal-evaluator
npx vite build

添加新应用

  1. 创建 packages/apps/my-new-app/ 和 package.json, tsconfig.json, vite.config.ts, index.html, src/main.ts
  2. 创建 packages/server/src/tools/my-new-app.ts 使用工具处理器
  3. 添加 packages/server/src/index.ts toolModules数组
  4. 添加 packages/gallery/src/main.ts APPS阵列
  5. 跑 npm install && npm run build

项目统计数据

度量 值
应用程序总数 45个仪表板应用程序+7个聊天演示
片段 18（包括聊天演示）
使用的API终结点 12
内置HTML包 45（每个约400KB，约98KB gzip压缩）
外部图表库 0（全部为Canvas 2D）
模拟数据 每个应用程序都有完全的离线回退

许可证

麻省理工学院

相关 MCP