JOY Automart

JOY Automart MCP 服务

面向 JOY Automart 的官方 Model Context Protocol 服务。JOY Automart 是孟加拉国的汽车零部件和车辆交易平台。它允许 AI 助手（Claude、ChatGPT、Cursor 和其他 MCP 客户端）搜索 JOY 的汽车零部件目录和 JOY Auto Exchange 车辆信息，比较车辆，查询零部件，并为人工买家准备购买交接信息。价格以 BDT 计。

远程端点	https://www.joyautomart.com/mcp
传输方式	Streamable HTTP（MCP protocol 2025-06-18 及更高版本）
身份验证	公共工具无需身份验证。可选买家令牌：Authorization: Bearer joyagt_...
文档	https://www.joyautomart.com/developers
服务卡片	https://www.joyautomart.com/.well-known/mcp/server-card.json

该服务由 JOY Automart 托管；使用时无需运行任何程序。本仓库包含公共元数据（注册表 server.json、Smithery 配置、工具快照），以及一个供仅支持本地服务的客户端使用的小型 stdio 代理。

工具

公共只读工具（无需账户）。快照来自实时 tools/list 调用（参见 tools.json）；* 表示必填参数。

工具	功能	参数
search_parts	搜索 JOY Automart 在孟加拉国的汽车零部件目录。	query、make、chassis、category、in_stock_only、include_rfq_catalogue、max_price_bdt、page、page_size
get_part	获取一个目录零部件的完整公开详情：BDT 价格、库存、最低订购量、经核实的报价和批量价格折扣。	part_id*
search_vehicles	按品牌、车型、年份、燃油类型和 BDT 价格搜索 JOY Auto Exchange 在孟加拉国的车辆信息。	query、make、fuel_type、verified_only、include_unpriced、min_year、max_year、min_price_bdt、max_price_bdt、sort、page、page_size
get_vehicle	获取一条 JOY Auto Exchange 车辆信息的完整公开详情（按信息 ID 或 slug）：BDT 价格、规格、照片；若车辆通过 JOY 的人工质检，还会提供检查摘要。	vehicle_id*
get_auction_status	获取一场正在进行或近期 JOY 拍卖的公开状态：当前 BDT 出价、出价次数、结束时间和防狙击延时。	auction_id*
compare_vehicles	并排比较 2 至 4 条车辆信息（使用 search_vehicles 返回的 ID 或 slug）：价格、年份、里程、燃油类型、验证状态和检查等级。	vehicle_ids*
get_buying_guide	了解如何从 JOY Automart 购买：货币（BDT）、付款方式（银行卡、bKash/Nagad/Rocket、货到付款）、达卡及全国配送区域和费用、人工联系方式，以及经过身份验证的 Agent 如何下单。	—
prepare_buyer_handoff	整理人工买家完成购买所需的链接：商品页面，以及预填了标准零部件详情和适配限制的 WhatsApp 消息。	part_id*、quantity、vehicle、note

所有公共工具均标注为 readOnlyHint: true。**适配信息仅供参考：**若没有 VIN/底盘证据，该服务绝不会声称零部件适配某辆车；购买前请向 JOY 销售团队确认。

使用买家签发的 Agent 令牌（在 https://www.joyautomart.com/cars/account?section=ai-agents&portal=retail 创建）后，Agent 还可以使用 quote_order、place_order（货到付款或经批准的贸易信贷，且不得超出买家消费限额）、create_rfq、get_order_status 和 list_my_orders。

连接

Claude（claude.ai / Claude Desktop）

设置 → 连接器 → 添加自定义连接器 → URL https://www.joyautomart.com/mcp。

ChatGPT

设置 → 连接器（开发者模式）→ 创建 → MCP 服务 URL https://www.joyautomart.com/mcp，身份验证：无。

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "joy-automart": { "url": "https://www.joyautomart.com/mcp" }
  }
}

VS Code / 任何支持远程 HTTP 的客户端

{
  "servers": {
    "joy-automart": { "type": "http", "url": "https://www.joyautomart.com/mcp" }
  }
}

Claude Code

claude mcp add --transport http joy-automart https://www.joyautomart.com/mcp

使用 curl 快速测试

curl -s https://www.joyautomart.com/mcp \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

本地 stdio 代理（npx）——即将推出

npm 包 @joyautomart/mcp-server 尚未发布。发布后，仅支持 stdio 的客户端可以使用：

{
  "mcpServers": {
    "joy-automart": {
      "command": "npx",
      "args": ["-y", "@joyautomart/mcp-server"],
      "env": { "JOY_AGENT_TOKEN": "joyagt_your_token_here" }
    }
  }
}

在此之前，你可以从此仓库运行代理（Node 18+）：

git clone https://github.com/www-joyautomart-com/mcp-server && cd mcp-server
npm ci
node bin/joyautomart-mcp.js            # or: --url https://www.joyautomart.com/mcp

JOY_AGENT_TOKEN 为可选项；无需该令牌即可使用公共工具。

列表

• 官方 MCP Registry 名称：com.joyautomart/mcp（server.json；列表待完成域名验证）
• Smithery 配置：smithery.yaml

支持

有关零件、订单或适配问题，请访问：https://www.joyautomart.com。有关此仓库的问题，请提交至 GitHub issues。

许可证

MIT © 2026 JOY Automart / Ahmed Joyadh