Servant 模型上下文服务端
使用说明内容(Markdown 格式)
- 项目简介
- Servant 是一个面向 LLM 的后端框架,实现了 MCP 协议的服务端能力,能够向客户端提供工具、资源(可选)和提示等接口,通过 JSON-RPC 进行通信,基于 Eclipse Vert.x 构建。
- 主要功能点
- 向 MCP 客户端注册并暴露工具,并为每个工具提供 JSON 架构描述,便于客户端按需调用。
- 处理 MCP JSON-RPC 请求与响应,维护会话信息、服务器能力声明。
- 通过 Vert.x Event Bus 及微服务式架构实现工具执行与结果回传。
- 支持通过不同传输方式(如 SSE)向客户端推送事件或通知。
- 安装步骤
-
- 通过 Git 克隆仓库。
-
- 使用 Maven 构建项目:mvn package
-
- 按需配置环境参数,并以 Vert.x 的方式启动应用入口。
-
- 服务器配置(MCP 客户端连接信息)
- MCP 客户端需要的配置仅包含服务器端启动命令及参数,示例(非代码文本,便于理解):
- server_name: servant-mcp-server
- command: vertx
- args: ["run", "EsXan.Servant.App", "--config=config/mcp-config.json"] 注释:以上配置用于指明 MCP 服务器的启动命令及其参数,MCP 客户端在连接时会使用该服务器信息进行初始化。具体配置路径与环境变量请按实际部署目录调整。
- 基本使用方法
- 启动后,MCP 客户端可通过 JSON-RPC 向服务器请求资源、工具调用和提示的渲染等能力,服务器将按照 MCP 约定进行请求处理并返回标准化的 JSON-RPC 响应。