JD.AI MCP 服务器实现

使用说明（简要、易操作的使用要点）

• 项目简介

  • 该仓库实现了一个 MCP 服务器端，作为后端服务提供对资源、工具和 Prompt 的统一管理，并通过 JSON-RPC 的 MCP 协议与客户端进行交互，支持多传输通道以实现与 LLM 客户端的无缝对接。

• 主要功能点

  • 资源管理：托管、查询和访问用于上下文的数据资源（Resources），便于 LLM 客户端获取所需数据。
  • 工具注册与执行：注册外部功能工具，允许 MCP 客户端调用并获取执行结果。
  • Prompt 模板渲染与管理：定义、渲染并提供可自定义的提示模板，支撑不同的交互模式。
  • JSON-RPC 通信：遵循 MCP 标准的请求/响应格式，实现资源读取、工具调用、提示获取等接口。
  • 会话与能力声明：会话上下文管理、能力声明、以及对外暴露的能力集合，确保安全、可扩展。
  • 多通道传输：支持 REST、SignalR、SSE、WebSocket 等传输协议，以适配不同的客户端场景。

• 安装步骤

  • 拷贝源码后，在本地安装 .NET 6+ 运行环境。
  • 构建解决方案并编译所有 MCP 相关模块。
  • 启动 MCP 服务器主程序，自动暴露 MCP API 入口，等待客户端连接。

• 服务器配置（MCP 客户端需要的最小信息，配置为 JSON，示例说明如下）

  • server name（服务器名称）
  • command（启动命令）
  • args（启动参数，数组形式） 说明：以下为配置示例的结构性描述，客户端不需要直接解析代码，只需按照下列字段向 MCP 服务器发起连接即可。
  • server_name: "jdai-mcp-server"
  • command: "dotnet"
  • args: ["JD.AI.Gateway.dll", "--mcp-mode", "server"]

• 基本使用方法

  • 启动服务器：按提供的命令行方式启动 MCP 服务器进程（例如通过 dotnet 命令启动 JD.AI.Gateway 项目的可执行程序集）。
  • 连接客户端：MCP 客户端通过 JSON-RPC 方式向服务器发起资源查询、工具调用、Prompt 获取等请求。
  • 运行与调试：通过服务器暴露的接口日志、健康检查、以及运行时配置进行监控与调试。

• 备注

  • 服务器实现会与 JD.AI 的 Gateway、通道适配器、工作流与插件/扩展等组件协同工作，形成一个完整的 MCP 后端服务端框架，支持上下文信息的提供和外部功能的扩展。