Climi MCP 服务端(Kimi 集成)
使用说明内容(Markdown格式)
项目简介
Climi 提供一套 MCP(Model Context Protocol)服务器组件,用于将 Kimi 的资源、工具、模板等上下文信息暴露给外部 AI 客户端(如 Claude Code 相关系统),并支持通过多种传输协议进行通信(stdio、SSE、WebSocket 等)。核心目标是为 LLM 客户端提供稳定、可扩展的上下文服务框架,便于调用外部工具、访问资源以及渲染提示模板。
主要功能点
- 实现 MCP 核心能力:读取资源、注册并执行工具、获取和渲染 Prompts 等能力(通过 JSON-RPC 等协议进行请求和响应)。
- 提供多传输协议支持:stdio、SSE、WebSocket 等,确保在不同环境下的可连接性与安全性。
- 资源与工具管理:托管数据资源、注册可调用的外部工具,允许 LLM 客户端执行外部功能。
- Prompt 模板渲染:定义和渲染可定制的 Prompt 模板,便于不同模式的 LLM 交互。
- 会话与能力声明:服务器端负责会话管理、能力宣告,便于客户端了解可用能力。
- 与 Claude Code 的集成:通过 Slash 命令、CLI 包装和钩子等实现对 MCP 服务的简化集成。
安装步骤
- 确保运行环境满足依赖:
- Kimi CLI、jq、Python(按仓库要求版本)、Git 等基本工具。
- 安装脚本与组件:
- 运行安装脚本(如 install.sh)以安装基础组件。
- 如需要,执行带有 MCP 与钩子的完整安装选项(--with-hooks)。
- 验证安装:
- 确认 kimi-mcp-server.sh、kimi-mcp.sh 等相关脚本存在并可执行。
- 确认系统中可用的 jq、Python 等依赖版本符合仓库要求。
服务器配置(MCP 客户端需要的最小信息)
MCP 客户端在建立连接前至少需要服务器启动信息(不依赖客户端代码),配置以 JSON 格式描述如下。请将下面字段替换为你实际环境中的路径与参数。注释用于解释各字段含义,但不会影响实际使用。
{ "server_name": "climi-kimi-mcp", "command": "/absolute/path/to/skills/kimi-mcp-server.sh", "args": [ "--port", "8000", "--bind", "127.0.0.1", "--transport", "stdio,sse,websocket" ] // server_name: 在客户端显示的服务器标识名称 // command: 启动 MCP 服务器的可执行脚本或可执行文件的绝对路径 // args: 启动参数列表,例如端口、绑定地址以及可用的传输协议(stdio、SSE、WebSocket 可以根据需要启用组合) }
说明:MCP 客户端无需此配置文件的具体实现代码;该配置仅用于描述服务器启动信息,客户端通过服务器启动命令与参数来连接并使用 MCP 服务。实际使用中,按仓库提供的安装与部署方式启动服务器即可。
基本使用方法
- 启动服务器:按仓库提供的脚本和流程运行,确保服务器成功监听指定端口和传输协议。
- 连接与使用:MCP 客户端通过指定的服务器地址与端口发起请求,服务器返回资源、工具调用能力、Prompts 等数据。
- 日常运维:关注日志输出,必要时通过 MCP 文档进行能力声明和模板更新,保持服务器与客户端的能力同步。