跳转到主要内容

​
MCP Server

​
概述

ORBEXA内置完整的MCP Server实现（OrbexaMCPServer类，定义在mcpServer.ts中），为AI代理提供标准化的工具调用和资源访问接口。AI代理无需理解底层数据库结构，直接通过MCP工具查询商品、库存和分类信息。

​
5个MCP工具

​
search_products

商品搜索工具，支持关键词、分类、价格范围等多维度搜索。 输入参数：
  • query — 搜索关键词
  • category — 商品分类（可选）
  • min_price / max_price — 价格范围（可选）
  • limit — 返回数量限制（可选）
输出：匹配的商品列表，包含名称、价格、库存状态和商品ID。

​
get_product

获取单个商品的完整详情。 输入参数：
  • product_id — 商品ID
输出：商品完整信息，包含描述、变体、图片、规格参数等。

​
check_availability

查询商品库存可用性。 输入参数：
  • product_id — 商品ID
  • variant_id — 变体ID（可选）
输出：库存数量和可用状态。

​
get_categories

获取商家的商品分类列表。 输入参数：无必填参数。 输出：分类树形结构，包含分类名称和商品数量。

​
get_brands

获取商家的品牌列表。 输入参数：无必填参数。 输出：品牌列表及关联商品数量。

​
3个MCP资源

MCP资源提供只读的数据访问，AI代理可以订阅资源获取实时更新。

​
ucp://inventory/:merchant_id

商家的实时库存数据。AI代理订阅此资源可获得库存变动通知。

​
ucp://catalog/:merchant_id

商家的完整商品目录。包含所有已发布商品的基本信息。

​
ucp://schema/ucp-standard

UCP标准Schema定义。AI代理可通过此资源了解UCP数据格式规范。

​
HTTP API路由

MCP Server通过以下HTTP端点对外暴露：
端点功能
/api/mcp/tools列出所有可用工具及其输入/输出Schema
/api/mcp/execute执行工具调用，传入工具名和参数
/api/mcp/resources列出所有可用资源及其URI
/api/mcp/usage查询API用量统计
/api/mcp/prompts获取预定义的提示词模板

​
认证方式

所有MCP端点都需要API密钥认证。AI代理在请求Header中携带API密钥： 
Authorization: Bearer <api_key>
API密钥在商家接入时自动生成（Shopify/WooCommerce/WordPress），或在控制台手动创建。

​
自定义域名支持

ORBEXA支持通过商家自定义域名访问MCP端点。通过mcpDomainRouter实现，商家可以将MCP服务绑定到自己的域名： 
https://shop.example.com/api/mcp/tools
而不仅限于ORBEXA平台域名。这让AI代理在发现商家域名后可以直接调用其MCP工具。

​
NPM包：OTR MCP工具

除了商家级MCP Server，ORBEXA还发布了独立的NPM包 @otr-protocol/mcp-server，提供OTR信任注册表的MCP工具：

​
verify_merchant

验证商家的信任评分。 输入：商家域名 输出：OTR信任评分、六维度详情、信任徽章

​
search_registry

搜索OTR信任注册表。 输入：搜索关键词 输出：匹配的已注册商家列表及其信任评分 这个NPM包可以独立安装到任何MCP客户端（如Claude Desktop），无需ORBEXA商家账户即可查询OTR信任注册表。

​
小结

ORBEXA MCP Server提供5个工具和3个资源，覆盖商品搜索、详情查询、库存检查、分类和品牌浏览。API密钥认证保障安全，自定义域名支持提升灵活性。独立NPM包让任何AI代理都能查询OTR信任注册表。
下一章：数据清洗与质量 — AI Refinery Pipeline、飞轮学习、HITL审核