kubectl-mtv MCP 服务器

使用说明

  • 项目简介
    • 该仓库实现的 MCP 服务器基于 Model Context Protocol,为 LLM 客户端提供可扩展的上下文服务,核心能力包括:托管资源(Resources)、注册与执行工具(Tools)、定义与渲染 Prompt 模板(Prompts),并通过 JSON-RPC 与客户端通信。服务器端负责会话管理、能力声明,以及支持多种传输协议(如 Stdio、SSE、WebSocket)。
  • 主要功能点
    • 资源托管与数据访问:提供对资源对象的读取、查询等能力,便于 LLM 客户端获取所需上下文信息。
    • 工具注册与执行:支持将外部工具注册到 MCP 服务器,LLM 客户端可通过标准化接口调用外部功能。
    • Prompt 模板渲染:定义与渲染 Prompt 模板,支持自定义交互模式以驱动对话流程。
    • JSON-RPC 通信:客户端通过 JSON-RPC 与服务器交互,获取资源、执行工具、获取 Prompts 等信息。
    • 会话与能力管理:服务器端负责会话生命周期与能力声明,确保对接的客户端了解可用能力。
    • 多传输模式:可在 STDIO(默认)、SSE(HTTP)等模式下工作,方便不同场景集成。
    • 动态工具发现:在启动时可通过注册中心自动发现并注册可用工具,提高扩展性与可维护性。
  • 安装与启动(简要流程)
    • 将 MCP 服务器二进制部署到目标环境(结合你的运行环境选择容器化或直接运行)。
    • 根据需要选择传输模式(默认 STDIO,若需要网页化的通信可启用 SSE)。
    • 如需 TLS,配置证书与私钥文件。
    • 启动命令示例(以 SSE 模式为例,实际参数请按需求调整):
      • kubectl-mtv mcp-server --sse --host 0.0.0.0 --port 8080
    • 启动后服务器将自动进行动态工具发现并注册,支持与 AI 助手进行 JSON-RPC 交互。
  • 服务器配置(MCP 客户端所需配置) 说明:以下配置用于 MCP 客户端连接并使用该 MCP 服务器。注意:MCP 客户端的具体参数对接依赖客户端实现,以下信息仅作示例说明,实际使用请按客户端文档填写。 { "serverName": "kubectl-mtv-mcp-server", "command": "kubectl-mtv", "args": [ "mcp-server", "--sse", "--host", "0.0.0.0", "--port", "8080", "--output-format", "json" ], "description": "MCP 服务器名称,启动命令及参数集合,用于与 MCP 客户端建立连接", "transport": "SSE", "endpoint": "http(s)://<server-host>:8080/sse", "notes": [ "动态工具注册:服务器启动时会进行工具发现并注册,确保客户端可以通过 MCP 调用工具。", "默认传输模式为 SSE,若客户端使用 STDIO,请调整传输设置。", "若需要安全传输,可提供 TLS 证书和私钥文件(通过 --cert-file 与 --key-file 配置)。" ] }
  • 基本使用方法
    • 运行 MCP 服务器后,LLM 客户端通过 JSON-RPC 发送请求,获取资源、执行工具、获取 Prompts 等上下文信息。
    • 客户端可通过以下典型路径与 MCP 服务器交互:
      • 读取资源:请求服务器返回所需资源数据以供对话使用。
      • 调用工具:请求执行某个注册的工具,返回执行结果或中间态信息。
      • 获取 prompts:获取适用于当前对话场景的 Prompt 模板,以驱动对话流程。
    • 服务器端负责会话维护、能力声明及在不同传输模式之间的协作。

服务器信息