Mantis Immersive Commerce MCP

Mantis MCP Server

用于基于现有电商目录构建高转化率沉浸式购物展厅的 AI 助手工具。基于 Mantis 的生产级沉浸式商务平台构建，该平台已被包括 New Balance 在内的《财富》500 强品牌采用，部署场景涵盖 2024 年巴黎奥运会、MLB、NHL 和英超联赛。

这是 Mantis 打造由 Agent 调用的沉浸式商务基础设施愿景的一部分。了解详情，请访问 mantisxr.com。

快速开始

npx mantis-mcp

也可以全局安装：

npm install -g mantis-mcp

然后在 Claude Desktop、Cursor 或任何兼容 MCP 的客户端中进行配置（请参阅下方的配置）。

状态

此 MCP 连接的 Mantis 展厅平台已投入生产使用，被包括 New Balance 在内的《财富》500 强品牌采用，部署场景包括 2024 年巴黎奥运会、Chicago Cubs（MLB）、St. Louis Blues（NHL）、Burnley FC 及其他英超俱乐部。此 MCP 服务用于将该平台提供给 AI Agent，目前仍在积极开发中。部分工具已完全接入真实平台 API；其他工具则暂时使用模拟数据，等待后端接口开发完成。请参阅下方的工具状态，了解哪些功能已真实可用、哪些仍在开发中。

设置

环境变量（可选）

配置这些变量以连接到真实的 Mantis API：

MANTIS_API_URL=https://your-mantis-instance.com
MANTIS_AUTH_TOKEN=your_token_here

Mantis 用户会在账户设置期间收到 API URL 和身份验证令牌。未配置这些变量时，工具会使用模拟数据进行代码生成和规划。

配置

Claude Desktop：

1. 打开 Settings → Developer → Edit Config
2. 添加：

{
  "mcpServers": {
    "mantis-mcp": {
      "command": "npx",
      "args": ["mantis-mcp"]
    }
  }
}

Cursor：

1. Settings → MCP Servers → Add new server
2. 使用 npx mantis-mcp 进行配置

其他 MCP 客户端： 使用 npx mantis-mcp 或 node /path/to/dist/index.js

工具

✅ 完全可用（无需 API）

installMantisSDK 生成安装命令和 .npmrc 配置，以便将 Mantis SDK 集成到 React、Vue、Next.js、Shopify 或原生 JavaScript 项目中。

createMantisIntegration 生成完整的、针对特定框架的集成代码，包含事件处理器、购物车集成和分析跟踪。

generateEventHandler 为 Mantis SDK 事件（cart-opened、model-click、variant-changed 等）创建事件处理器代码。

analyzeConsoleErrors 通过模式匹配识别常见错误（SDK 未加载、postMessage 被阻止、WebGL 问题），并提供包含代码示例的修复方案。

checkBrowserCompatibility 检查浏览器对 WebGL、postMessage、全屏和其他沉浸式功能的兼容性，并提供 polyfill 建议。

🟡 部分可用（配置后使用真实 API）

validateSetup 验证 Mantis SDK 安装。如果已配置 MANTIS_API_URL，则调用真实的 showrooms.getShowroom API；否则返回示例验证检查结果。

importCatalog 从 Shopify（真实 API）、CSV 或手动输入导入产品目录。数据解析成功；后端存储接口尚待开发。

createStore 创建沉浸式展厅。如果已配置，则尝试调用真实的 showrooms.createShowroom API；否则返回模拟响应和操作指南。

publishStore 发布展厅使其上线。如果已配置，则尝试调用真实的 showrooms.updateShowroom API；否则模拟将状态更改为 active。

🔴 模拟功能（使用模拟数据，后端接口尚待开发）

debugPostMessage 模拟 postMessage 调试场景，提供逼真的消息时间线、来源检查和错误模式。

testMantisEvent 模拟 SDK 事件测试（model-loaded、add-to-cart 等），包含验证和性能计时。

simulateUserFlow 模拟多步骤用户交互流程（加载 → 点击 → 加入购物车），包含逼真的延迟和错误场景。

getPerformanceMetrics 根据请求的指标生成模拟性能数据（FPS、加载时间、内存、GPU）。

analyzeEventFlow 模拟事件流分析，包含转化漏斗、流失节点和用户行为模式。

此 MCP 不做什么

沉浸式资源生成： Mantis 不会自动将产品照片转换为可用于沉浸式体验的资源。商家在创建产品时，必须提供可用于沉浸式体验的资源（.glb/.gltf 文件）。这是有意的范围界定：自动化资源生成是一种正在商品化的服务层，多家公司都曾尝试提供这类服务，但未能建立可持续发展的业务。Mantis 的价值在于沉浸式展厅平台、商品陈列智能，以及可由 Agent 调用的商务基础设施，而非资源生成。

开发

# Clone and install
git clone https://github.com/kahlilashanti/mantis-mcp.git
cd mantis-mcp
npm install

# Build
npm run build

# Run locally
npm start

许可证

MIT

链接

• Mantis 平台
• GitHub 问题
• 模型上下文协议