ACP Commerce MCP Server

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”。