Trade Agent MCP Server

关键词

跨境电商微服务SSE工具调用会话上下文

使用说明内容（Markdown格式）

  • 项目简介

    • 该仓库实现了一个基于 MCP（Model Context Protocol）的后端服务器，用于向跨境电商场景中的大语言模型客户端提供资源访问、工具调用以及 Prompts 的定义与渲染。核心是 Java-Spring Boot 的 MCP 服务器，提供购物车、订单、物流、邮件等工具，通过 SSE 端点对外暴露，LLM 客户端可通过 JSON-RPC 风格的请求调用工具。

  • 主要功能点

    • MCP 服务端框架与工具注册
    • 四类 MCP Tool：购物车查询、订单查询、物流查询、邮件发送（含人工确认环节）
    • SSE 端点对外暴露工具，客户可发现并调用
    • 数据持久化与日志：MySQL、MyBatis 映射、邮件日志、聊天记录
    • 会话管理与工具调用链路（通过 Tool 注解实现自动注册）
    • 与 Python 侧的 trade-agent-brain 进行跨语言协作（SSE 通信、工具调用链路）

  • 安装步骤

    • 前提条件：Java 11+/17 环境、Maven、MySQL 数据库、Redis、Milvus（可选，作为向量检索后备）
    • 构建与打包
      • 进入仓库根目录，执行构建（跳过测试以加快）：
        • mvn -f trade-mcp-server/pom.xml clean package -DskipTests
    • 运行 MCP 服务器
      • 启动命令示例（请结合实际打包后的 jar 名称与端口调整）：
        • java -jar trade-mcp-server/target/trade-mcp-server-0.0.1-SNAPSHOT.jar --server.port=8081
    • 运行后，MCP 服务器将通过 SSE 提供 /sse 路径的工具接口，MCP 客户端通过该端点发现并调用工具

  • 服务器配置（JSON，MCP 客户端需要的最小信息）

    • 说明：以下配置用于 MCP 客户端建立与 MCP 服务器的连接，包含服务器名称、启动命令及参数等信息。MCP 客户端通常不需要代码级配置，仅使用此 JSON 描述来了解连接信息与启动参数。
    • 配置示例 { "server_name": "Trade-MCP-Server", "command": "java", "args": [ "-jar", "trade-mcp-server/target/trade-mcp-server-0.0.1-SNAPSHOT.jar", "--server.port=8081" ], "notes": "请确保数据库、缓存与向量检索服务就绪。MCP 客户端通过 /sse 路径与该服务器建立连接，进行工具调用和上下文获取。" }

  • 基本使用方法

    • 启动阶段
      • 确保 MySQL、Redis、Milvus（若使用向量检索）等依赖服务正常运行
      • 按上述步骤构建并启动 MCP 服务器
    • 客户端对接
      • MCP 客户端通过 SSE（/sse）发现服务器并调用注册在 MCP Server 上的工具
    • 常见使用场景
      • 查订单状态、查询物流信息、查看购物车、发送邮件通知（需人工确认）
    • 运行与维护
      • 监控日志（MCP 服务端日志、数据库日志、邮件日志），确保订正工具调用链路

服务器信息

访问项目