关键词

智能采购工具网关多代理协同审计证据电商自动化

使用说明内容（Markdown格式）

  • 项目简介
    • 该仓库实现以 MCP（Model Context Protocol）为核心的后端服务体系，涵盖核心 MCP 服务器（core-mcp）、结账相关 MCP（checkout-mcp）以及一个工具网关（tool-gateway）等组件。通过 JSON-RPC/Envelope 风格的协议，向基于LLM的客户端提供资源管理、工具执行、以及可定制的 Prompt 模板渲染等能力，支持多代理协同完成复杂任务，并提供Evidence Snapshot 等审计能力。
    • 实现要点包括：MCP 服务器对外暴露工具集合、基于 Tool Gateway 的统一调用、以及跨服务的数据流（从意图解析到候选召回、实时核验、方案计划再到Draft Order 的创建与证据快照附带）。
  • 主要功能点
    • MCP 服务器核心：实现 MCP 的 ListTools / CallTool 等请求处理，支持多服务分组、幂等、审计、以及安全策略（示例中以开发模式为主）。
    • 工具注册与执行：core-mcp、checkout-mcp 等实现了 catalog、pricing、shipping、compliance、evidence、checkout 等工具，并提供输入输出契约（inputSchema），确保工具调用的一致性。
    • Agent 体系对接：通过 Tool Gateway 将工具暴露给客户端，LLM 客户端可以发起请求读取资源、调用工具、获取 AR OC (AROC) 等信息。
    • 审计与证据：evidence 快照、工具调用记录、以及证据哈希等字段支持可回放的审计能力。
    • 数据与数据库能力：提供 PostgreSQL 数据库集成、初步种子数据导入脚本，以及简单的查询/事务工具。
  • 安装步骤
    • 环境要求：Node.js、TypeScript 支持的工作区环境、Python（Agents 端）、PostgreSQL 数据库（Docker 方式为 MVP 提供数据存储）。
    • 依赖安装与服务启动的常用路径（按仓库中的快速启动指引组合描述，不含具体代码块）：
      • 安装工作区依赖：在仓库根目录执行包管理器安装（如 pnpm、npm、yarn 的对应安装命令），确保工作区各包能正确解析。
      • 启动数据库：使用 docker-compose 启动 PostgreSQL 实例（与数据密切相关的服务）。
      • 启动 Tool Gateway：启动 Tool Gateway 服务，用以路由 MCP 客户端对工具的请求。
      • 启动 MCP 服务器：分别启动 core-mcp 与 checkout-mcp（以及其它需要的 MCP 服务）。
      • 启动 Agent 端：按示例运行 Python 代理/Agent，完成意图解析与执行流程的演示。
    • 注意事项：本仓库在开发阶段使用 MOCK 模式，真实环境下需要接入实际数据源并启用全部安全/审计等生产规范。
  • 服务器配置（MCP 客户端需要的启动信息）
    • MCP 客户端需要使用一个配置来连接各 MCP 服务器。以下为示例配置（JSON 格式，表示不同 MCP 服务器的启动命令与参数，勿直接用于代码中，供理解与文档使用）。
    • 示例配置（JSON，按服务器逐条列出）： [ { "server_name": "core-mcp", "command": "pnpm", "args": ["--filter", "core-mcp", "dev"], "description": "核心 MCP 服务器，聚合 Catalog、Pricing、Shipping、Tax、Compliance 等工具的实现。" }, { "server_name": "checkout-mcp", "command": "pnpm", "args": ["--filter", "checkout-mcp", "dev"], "description": "结账相关 MCP 服务器，提供购物车、草稿单、证据等工具。" }, { "server_name": "tool-gateway", "command": "pnpm", "args": ["--filter", "tool-gateway", "dev"], "description": "工具网关，统一暴露工具接口并对外路由 MCP 请求。" } ]
  • 基本使用方法
    • 运行方式简述：在本地开发环境中，按照上述服务器配置逐步启动核心 MCP、结账 MCP 以及工具网关等组件，并在 PostgreSQL 启动后进行数据种子加载和简单的端到端演示。
    • 使用流程概览：LLM 客户端通过工具网关统一访问 MCP 服务提供的工具，工具返回标准 Envelope，其中包含 data、evidence、ttl 等信息，客户端据此进行决策与展示，并可将关键步骤通过 Evidence 快照进行审计回放。
    • 运行示例（高层次描述，不涉及代码）：
      • 启动数据库，并确保所需表和种子数据就绪。
      • 启动 Tool Gateway，确保路由到 MCP 服务器的能力可用。
      • 启动 core-mcp 与 checkout-mcp，确保工具列表和调用接口可用。
      • 启动 Python Agents，演示从用户意图到 drafting 的完整工作流。
    • 互动与扩展：代码中提供了 MOCK 模式下的工具调用演示，实际使用时可接入真实工具实现和外部系统，并通过 Evidence 快照实现回放与审计。

信息

分类

AI与计算

访问项目