Kubani Registry MCP Server

关键词

元数据注册服务发现JSON-RPCLLM 集成端点管理

使用说明（Markdown 要点版）

  • 项目简介

    • 本仓库实现了一个 MCP 服务器，用于向 MCP 客户端暴露 Kubani Registry 的元数据能力，包括代理/模型/端点等实体的查询、创建、修改等能力，以及对 MCP 服务器的管理性支持。服务器采用 JSON-RPC 风格的 MCP 协议，提供工具集、资源、模型等的查询与操作能力，方便 LLM 客户端进行外部系统集成。

  • 主要功能点

    • 提供 MCP 服务端入口，接收初始化请求与工具调用请求并返回标准化的 JSON-RPC 响应。
    • 暴露注册、查询、更新和删除若干元数据模型（代理、模型、端点、部署、 Syndicate/Skill 等）相关的工具与接口。
    • 支持工具列表、单工具执行、模型与端点的查询、以及对 MCP 服务器的策略/策略组管理（策略路由、策略查询等）。
    • 与 Kubernetes/云端服务结合，支持服务发现与资源注册等场景（通过独立的服务发现模块实现对服务的发现并注册为端点资源）。
    • 提供健康检查、就绪检查与指标/监控入口。

  • 安装步骤

    • 安装运行环境（Python 3.9+，依赖项通过 Pip/Poetry 安装）。
    • 安装依赖并配置数据库、缓存与外部服务端点（如 PostgreSQL、Redis、以及所需的外部模型服务）。
    • 启动 MCP 服务器实例（示例：使用 uvicorn 运行 kubani_registry.main:app，监听所需端口）。
    • 启动后端服务后，客户端可通过 MCP 规范的初始化请求建立会话，并通过 tools/call 调用具体工具。

  • 服务器配置（给 MCP 客户端的启动配置示例，JSON 形式，请据实填写） 说明：以下信息用于 MCP 客户端建立与本 MCP 服务器的连接与交互，其中 server_name 对应服务器在 MCP 注册表中的标识，command/args 表示启动该 MCP 服务器的命令及参数（具体请按客户端要求提供原始启动信息）。注释仅用于帮助理解，不作为代码直接执行。

    { "server_name": "kubani-registry", "transport": "stdio", "command": ["uv"], "args": ["run", "registry-mcp"], "description": "Kubani Registry 的 MCP 服务器，提供对 registry 服务元数据的工具与资源访问" }

    备注：

    • 客户端需要的仅是服务器名称、启动命令与参数（如上 JSON 结构），实际运行时请依据目标环境的容器编排与部署方式调整命令。
    • MCP 客户端在实际连接时会以该服务器为对等端，通过 initialize、tools/list、tools/call 等接口进行交互。

  • 基本使用方法

    • 在开发或测试环境中，按上述 JSON 配置启动 MCP 服务器。
    • MCP 客户端通过初始化握手后，可以调用 list_tools、call_tool、list_resources、read_resource 等接口获取资源与执行工具。
    • 结合 Kubani Registry 的元数据，LLM 客户端可以实现自动化查询、聚合和决策，使 AI 能力具备对元数据的上下文驱动能力。

服务器信息

访问项目