使用说明（Markdown 格式）

• 项目简介

  • 此仓库中的 dat-servers/dat-server-mcp 模块实现了一个 MCP 服务端，用于向具备 MCP 客户端能力的代理/LLM 客户端提供统一的资源、工具以及上下文模板等能力。服务端通过 Spring Boot 架构运行，并暴露一个 ToolCallback 入口，允许外部代理通过 MCP 的工具机制调用后端的业务逻辑。

• 主要功能点

  • MCP 服务端核心：接收并处理来自 MCP 客户端的工具调用请求，返回工具执行结果和上下文信息。
  • 工具暴露：通过 McpToolsService 将数据查询、代理信息等工具对外暴露，支持工具注册、调用与返回结果。
  • 会话与上下文：维护会话能力（conversationId）、历史记录（历史对话数据）及工具执行结果，方便 LLM 客户端在对话中复用上下文。
  • 与后端服务的集成：通过 Spring Boot 应用注入的服务组件实现对项目、代理及其配置的加载与执行。
  • 安全与扩展性：使用 Spring 的组件化特性、对外暴露的工具回调提供可扩展的能力，便于接入更多工具与数据源。

• 安装与运行步骤

  • 构建运行环境：需要 Java 17+（OpenJDK 搭配 Maven 构建）。
  • 构建整个项目（含 MCP 服务端模块）：
    • 在仓库根目录执行 Maven 构建，跳过测试以加速构建。
  • 启动 MCP 服务端（示例命令，实际请替换为打包后的 jar 路径与参数）：
    • 运行命令示例：java -jar dat-server-mcp-<版本>.jar --spring.profiles.active=mcp --server.port=8081 --server.address=0.0.0.0 --dat.server.project-path=/path/to/your/mcp-project
    • 说明：
      • --spring.profiles.active=mcp 指定启用 MCP 模式的 Spring 配置。
      • --server.port 指定服务端监听端口（默认 8081）。
      • --server.address 指定监听地址（如 0.0.0.0）。
      • --dat.server.project-path 指向 MCP 服务使用的项目目录（后续资源、工具等的配置基础路径）。
      • 运行时可按需传入 --dat.server.variables.* 形式的动态变量，用于在启动时注入全局环境。
  • 部署后端与客户端的对接通常需要在客户端/代理配置中指向此 MCP 服务器的地址、端口与启动参数，以建立会话并调用工具。

• 服务器配置示例（JSON，供 MCP 客户端参考，不需要直接复制到代码中）

  • server_name: "DAT MCP Server"
  • command: "java"
  • args: [ "-jar", "dat-server-mcp-<version>.jar", "--spring.profiles.active=mcp", "--server.port=8081", "--server.address=0.0.0.0", "--dat.server.project-path=/path/to/your/mcp-project" ] 注释：该 JSON 提供了 MCP 客户端启动时的必要信息字段，描述了服务器的名称、运行命令以及启动参数。实际使用时请将 <version> 替换为打包后的版本号，以及将 /path/to/your/mcp-project 替换为实际的项目目录。

• 基本使用方法

  • MCP 客户端配置后连接到服务器，通过工具接口调用后端暴露的工具。
  • 通过 MCP 的会话机制维持会话上下文，LLM 客户端可在对话过程中多轮调用工具、读取资源并获取语义结果。
  • 如需扩展工具集，可以在 McpToolsService 增加新的 @Tool 注解的方法，服务端会自动暴露给 MCP 客户端。

• 运行与运维注意点

  • 启动前确保 Java 环境与 Maven 构建产物正确，并且项目路径存在且可访问。
  • MCP 服务启动后请确保网络可访问性，必要时配置防火墙或反向代理。
  • 对生产环境，建议使用进程管理器（如 systemd）或容器化部署以确保高可用与日志聚合。