商业运营基金会MCP服务器
人工智能时代的通用履行系统
商业运营基金会MCP服务器实现了订单网络交换标准（onX），通过模型上下文协议（MCP）在人工智能代理和履行系统之间提供了一个标准化的接口。
该项目使像Claude这样的人工智能助手能够与任何履行系统无缝交互，简化从订单捕获到交付的商业运营。
项目目的
- 规范履行整合：为履行操作定义通用协议
- 实现人工智能驱动的商务：允许AI代理管理订单、库存和履行
- 简化实施：为不同的Fulfillment后端提供即插即用适配器
- 加速创新：为下一代商业自动化奠定基础
项目结构
/服务器
核心履行MCP参考服务器实现：
- 处理MCP协议通信（stdio传输）
- 将请求路由到适当的适配器
- 提供12个标准化的履行操作（5个操作+7个查询工具）
- 包括用于测试的内置模拟适配器
/适配器模板
用于创建自定义履行适配器以允许MCP参考服务器连接到您的履行系统的模板：
- 用于新集成的Boilerplate代码
- TypeScript接口和类型
- 测试框架设置
- 供应商发布指南
/docs
全面的文件涵盖：
- 订购网络交换规范和标准
- 架构和设计决策
- 不同利益相关者的整合指南
- API参考和示例
/模式
JSON模式定义：
- 订单数据结构
- 客户信息
- 产品目录
- 库存模型
快速开始
面向AI开发人员
将订单管理功能集成到您的AI应用程序中：
git clone https://github.com/commerce-operations-foundation/mcp-reference-server.git
cd mcp-reference-server/server
npm install
npm run build
node dist/index.js默认情况下，服务器使用模拟适配器(ADAPTER_TYPE=built-in, ADAPTER_NAME=mock).配置您的AI平台（如Claude Desktop）以执行 node /absolute/path/to/server/dist/index.js。请参阅 安装指南 针对特定平台的设置。
对于配送供应商
为您的履行系统创建适配器：
# Copy the adapter template
cp -r adapter-template your-fulfillment-adapter
cd your-fulfillment-adapter
# Install dependencies and start developing
npm install
npm run dev适用于零售商和商业平台
使用您选择的适配器部署服务器：
git clone https://github.com/commerce-operations-foundation/mcp-reference-server.git
cd mcp-reference-server/server
npm install
cp .env.example .env
# edit .env and set ADAPTER_TYPE/ADAPTER_PACKAGE/ADAPTER_PATH as needed
npm run build
npm start核心能力
服务器提供12个基本的履行操作：
行动工具
create-sales-order-从任何渠道创建新订单update-order-修改订单详细信息和行项目cancel-order-取消订单并跟踪原因fulfill-order-将订单标记为已完成并返回装运详细信息create-return-通过退款/换货跟踪为订单项目创建退货
查询工具
get-orders-检索订单信息get-customers-获取客户详细信息get-products-获取产品信息get-product-variants-检索变量级数据get-inventory-检查库存水平get-fulfillments-跟踪履行状态get-returns-查询退货记录和状态
架构概述
┌──────────────┐ ┌────────────────┐ ┌──────────────────┐
│ AI Platform │────▶│ MCP Server │────▶│ Fulfillment │
│ (Claude) │ │ (This Project) │ │ Adapter │
└──────────────┘ └────────────────┘ └──────────────────┘
│ │
▼ ▼
┌─────────┐ ┌──────────┐
│ Schemas │ │Fulfillment│
│ (JSON) │ │ Backend │
└─────────┘ └──────────┘测试
该项目包括各级综合测试：
# Run all tests
cd server
npm test
# Run specific test suites
npm run test:unit # Unit tests
npm run test:integration # Integration tests
# Test with coverage
npm run test:coverage文档
文件可在以下位置获得：
贡献
我们欢迎社区的贡献！无论您是：
- 创建适配器的履行供应商
- 开发人员改进核心服务器
- 用户报告问题或建议功能
请打开问题或拉取请求以开始。
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
资源
开始使用
准备好用人工智能彻底改变您的物流运营了吗？
我们正在共同为人工智能驱动的商业运营奠定基础。