商业协议服务器

一个生产就绪的模型上下文协议(MCP)服务器,实现x402协议和代理商业协议(ACP),使AI代理能够通过基于Node.js、TypeScript和Express的标准化、类型安全接口执行商业操作。

  • by gratitude5dee
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 gratitude5dee/wzrdmcp

使用说明

ACP商务MCP服务器

一个可投入生产的模型上下文协议(MCP)服务器,该服务器实现了x402协议(版本2025-09-29)和代理商业协议(ACP)。该服务器通过基于Node.js、TypeScript和Express构建的标准化、类型安全的接口,使AI代理能够执行商业操作。

主要特点

  • 完全符合x402请求/响应头的要求
  • 符合ACP规范的平坦响应和误差结构
  • 基于SSE的MCP传输,配备会话感知工具
  • 商家会话、产品信息推送/搜索以及支付协调服务
  • 幂等性、速率限制、签名验证和结构化日志记录
  • 全面的单元测试、集成测试和合规性测试
  • 使用GitHub Actions CI流水线进行Docker化部署

入门指南/开始使用

npm install
npm run build
npm start

在开发过程中,您可以运行带有实时重载功能的服务器:

npm run dev

进行质量检查:

npm run typecheck
npm run test:unit
npm run test:integration
npm run test:coverage

仓库结构

src/
  index.ts
  types/
  services/
  tools/
  routes/
  middleware/
  utils/
docs/
  API.md
  MCP_TOOLS.md
  SETUP.md
  DEPLOYMENT.md
  TROUBLESHOOTING.md

如需详细的设置和使用说明,请参阅 docs/SETUP.md 翻译为中文是:“文档/安装指南.md”。不过,这里的“docs”通常指的是“文档(documents)”的缩写,“SETUP.md”则是一个Markdown格式的文件,用于描述安装或设置过程。所以,一个更自然的翻译可能是“安装文档/SETUP指南.md”或者“文档/安装说明.md”,具体取决于上下文和文件的具体内容。但基于直接翻译,“docs/SETUP.md”可以翻译为“文档/安装指南.md”。