Khoregos 模型上下文服务端
- 项目简介
- Khoregos 是一个面向 Claude Code 等 LLM 客户端的模型上下文后端实现,核心职责是以标准化方式向客户端提供上下文信息和功能,包括资源托管、工具注册与执行,以及 Prompt 模板的定义与渲染。服务器通过 MCP 协议与客户端通信,接收如读取资源、调用工具、获取 Prompt 等请求,并返回 JSON-RPC 响应或发送通知。服务器还负责会话管理、能力声明,以及便于扩展的插件/传输实现。
- 主要功能点
- 资源管理:后端托管并提供对资源的访问能力,便于 LLM 客户端获取上下文数据与材料。
- 工具注册与执行:向客户端暴露可调用的外部功能(Tools),支持 LLM 通过 MCP 调用外部实现。
- Prompt 模板渲染:定义并渲染可定制的提示模板,支持多种交互模式。
- JSON-RPC 通信:与客户端以标准的 JSON-RPC 风格消息进行请求/响应交互。
- 会话与能力声明:跟踪会话生命周期,声明并暴露服务器能力,便于客户端理解可用的资源与工具。
- 多传输协议支持(设计层面)与当前实现示例:理论上可支持多种传输协议,当前采用通过标准输入输出(stdio)进行 MCP 交互的实现示例,便于在 Claude Code 插件/集成中直接使用。
- 与 Claude Code 集成:提供插件化入口、Hooks 与 MCP 服务器的打包,便于在 Claude Code 环境中实现治理能力。
- 安装与运行(简要)
- 安装依赖:在项目根目录执行安装命令以安装所需依赖。
- 构建/编译:执行构建步骤将 TypeScript 源码编译为可执行的运行组件(如 dist/ 目录)。
- 运行 MCP 服务:使用 CK 入口执行 MCP 服务器,例如通过命令启动 MCP 服务,启动后服务器将监听并响应来自 LLM 客户端的请求。
- 服务器配置(MCP 客户端需要,示例以 JSON 表达)
- server 名称:khoregos
- command:指向运行 Khoregos MCP 服务端的可执行文件路径(例如你在运行环境中实际使用的 k6s CLI 可执行路径)
- args:包含启动参数,常见为 ["mcp","serve","--project-root","<你的项目根路径>"]
- 以上配置信息用于 MCP 客户端建立连接,确保客户端知道服务器名称、启动命令及参数以便对接。
- 基本使用
- 启动 MCP 服务器后,客户端可通过该 MCP 服务实现资源读取、工具调用与提示渲染等功能。
- 结合 Claude Code 插件/集成,便可在模型推理时获得标准化的上下文服务和工具能力。