zkmin MCP 服务器实现

关键词

Model Context ProtocolJSON-RPC资源管理工具执行提示模板

使用说明

  • 项目简介
    • zkmin 的 MCP 服务器实现是一个端到端的后端服务，专门用来向 LLM 客户端提供标准化的上下文信息、可注册执行的工具、以及可渲染的 Prompt/模板。它通过 JSON-RPC/HTTP API 与客户端通信，具备资源管理、工具注册与执行、以及基于提示模板的渲染能力，且可通过不同传输协议（如 HTTP/SSE）进行传输。
  • 主要功能点
    • 资源托管与访问：集中管理可供 LLM 调用的资源数据，便于 LLM 读取和使用上下文。
    • 工具注册与执行：注册可调用的外部功能，LLM 通过服务器进行远程工具调用。
    • Prompt/模板定义与渲染：提供可定制的 Prompt 模板与渲染逻辑，支持不同的互动模式。
    • JSON-RPC 交互：服务器端以 JSON-RPC 的格式接收请求并返回响应或通知。
    • 会话与能力声明：服务器端维护会话状态、能力声明以及访问控制策略。
    • 多传输协议支持：支持通过 HTTP/SS E 等传输方式与客户端通信，以适应不同部署场景。
  • 安装步骤
    • 需要具备 Rust 开发环境，按照仓库提供的构建与运行方式进行编译与部署（仓库内含完整的 MCP 服务器实现代码与运行说明）。
    • 常见构建流程：在仓库根目录执行 cargo build --release（具体路径以实际模块为准），生成可执行文件后按需运行。
  • 服务器配置
    • MCP 服务器的配置需要包含一个服务器名称，以及启动命令与参数，以便 MCP 客户端能够从该信息中启动并连接到服务器。以下为示例配置（JSON 格式，供 MCP 客户端使用或协同化工具读取，不代表源码机制的直接调用代码）： { "server_name": "zkmin-node-1", "command": "zkmin", "args": ["node", "--mcp-port", "9091"], "transport": "sse", "mcp_endpoint": "http://localhost:9091/mcp", "description": "zkmin 本地节点 MCP 服务，提供资源、工具与 prompts 的访问接口" } 说明：
    • server_name：用于标识 MCP 服务器的名称，便于在多节点集群中区分。
    • command/args：用于 MCP 客户端启动服务器的命令与参数，便于本地化开发或自动化测试环境复现该服务器实例。
    • transport：建议使用 sse（若支持），也可按实际部署选择合适的传输协议。
    • mcp_endpoint：MCP 服务实际对外暴露的入口地址，一般为 http://<host>:<mcp-port>/mcp。
  • 基本使用方法
    • 启动资产：运行 zkmin 节点命令并开启 MCP端口，例如 zkmin node --mcp-port 9091；服务器启动后监听 /mcp 路径对外提供 MCP 服务。
    • 客户端接入：LLM 客户端通过配置指定的 MCP 服务器地址与传输方式（如 SSE）来建立连接，使用标准的 JSON-RPC 请求格式与响应进行资源/工具/提示相关的调用。
    • 日志与监控：关注启动日志与 /mcp 路径的返回信息，结合仓库自带的健康/状态工具接口，确保服务器就绪并可访问。
    • 兼容性提示：如需在多节点集群中部署，确保每个节点的 MCP 端口互不冲突，且各自的资源/工具命名空间保持互不干扰。

服务器信息

访问项目