Kastell MCP 服务端

使用说明

• 项目简介
  • Kastell 提供一个 MCP 服务器端实现，旨在以标准化的接口向 LLM 客户端提供云资源管理、外部工具交互以及可渲染的提示模板等能力，帮助在 AI 驱动的工作流中灵活获取上下文信息与执行外部功能。
  • MCP 服务器通过 JSON-RPC 与客户端通信，处理资源读取、工具调用、Prompt 获取等请求，并返回结构化的 JSON-RPC 响应或通知。
• 主要功能点
  • 资源管理与数据访问：托管与查询资源、服务器、备份等信息，便于 LLM 客户端获取上下文数据。
  • 工具注册与执行：注册可供 LLM 调用的工具，执行外部功能（如云提供商操作、备份/恢复、健康检查等）。
  • Prompt 模板与渲染：定义并渲染用于 LLM 交互的提示模板，支持可定制化的交互模式。
  • 会话管理与能力声明：维护会话上下文、能力声明，以及对不同传输协议的支持。
  • 安全与扩展性：在实现中考虑输入校验、权限控制、日志与监控，以及未来的插件化扩展。
  • 传输协议支持：可通过标准输入/输出、SSE、WebSocket 等通道与客户端通信，确保在不同环境下的可用性。
• 安装与运行
  • 在本地或服务器环境安装依赖、构建并启动 MCP 服务端（通常通过 Node.js 运行）。
  • 启动后，MCP 服务器将监听 JSON-RPC 请求，等待来自 LLM 客户端的资源、工具、提示等请求。
• 服务器配置（MCP 客户端需要的最小信息）
  • MCP 客户端需要配置的启动信息通常包含服务器名称、启动命令和参数，便于建立与 MCP 服务器的连接。示例配置如下（以 JSON 形式呈现，便于粘贴到客户端配置文件中；客户端本身并不需要你实现服务器端的具体实现细节，只需要正确指向服务器即可）： { "mcpServers": { "kastell": { "serverName": "kastell-mcp", "command": "npx", "args": ["-y", "-p", "kastell", "kastell-mcp"], "env": { "HETZNER_TOKEN": "your-token", "DIGITALOCEAN_TOKEN": "your-token", "VULTR_TOKEN": "your-token", "LINODE_TOKEN": "your-token" } } } } 备注：以上字段含义
  • serverName: MCP 服务器的名称标识，客户端用以区分不同服务器实例。
  • command: 启动服务器所执行的命令，如 npx、node 等。
  • args: 启动命令的参数数组，决定服务器如何被执行。
  • env: 运行时所需的环境变量（如各云提供商的 API 令牌）。注：实际使用中请根据你的运行环境提供有效的令牌。
• 基本使用方法
  • 将 MCP 服务器与 LLM 客户端对接后，LLM 客户端可以通过标准化的 JSON-RPC 请求读取资源、调用工具、获取 Prompts，并获得结构化响应，从而在对话中获得上下文信息、执行外部功能以及获得定制化的提示模板。
  • 通过提供的工具集合，LLM 客户端能够查询服务器状态、获取资源、执行维护/备份等操作，从而实现对 AI 驱动的基础设施管理和运维能力的无缝对接。