> ## Documentation Index
> Fetch the complete documentation index at: https://learn.orbexa.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ORBEXA MCP Server工具与资源

> ORBEXA MCP Server工具与资源完整接入指南：详细介绍search_products等5个MCP工具和3个标准资源的调用方式与参数说明，让ChatGPT和Claude等AI代理通过标准化MCP接口直接查询商品目录与库存状态信息，涵盖SSE传输配置与安全认证

# MCP Server

## 概述

ORBEXA内置完整的MCP Server实现，为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信任注册表。

***

下一章：[数据清洗与质量](/zh/book-7/ch7-data-quality) -- AI Refinery Pipeline、飞轮学习、HITL审核