Kubernetes管理IDE桥接工具

@库诺比/mcp

MCP桥 库诺比，桌面平台管理IDE。AI助手管理Kubernetes、FluxCD、ArgoCD和Helm，而用户则保持实时视觉监督。

库诺比是什么？

库诺比 是一个用于平台工程的桌面IDE——使用Rust和React构建，没有Electron。

• 通过资源浏览器、YAML编辑器和嵌入式终端实时查看集群
• 原生FluxCD、ArgoCD和Helm支持
• 用于AI助手的内置MCP服务器（Claude Code、Cursor、Windsurf、Codex CLI、Gemini CLI、GitHub Copilot CLI）
• 适用于macOS、Windows和Linux
• 无需帐户，无云依赖

设置

在Kunobi中启用MCP 设置>AI和MCP，然后安装：

自动（推荐）

一步完成所有AI客户端的注册：

npx @kunobi/mcp --install

这会交互式地检测您安装的AI客户端，并向它们注册服务器。支持的客户端：

• 克劳德代码 --项目或用户范围
• 克劳德桌面 --用户范围
• 光标 --项目或用户范围
• 帆板运动 --项目或用户范围
• Codex 命令行界面 --项目或用户范围
• Gemini CLI --项目或用户范围
• GitHub Copilot命令行界面 --用户范围

要从所有客户端中删除服务器，请执行以下操作：

npx @kunobi/mcp --uninstall

更新

install 将你的客户固定到一个精确的版本（例如。 @kunobi/mcp@1.2.3)所以每个 启动从npm缓存运行，而不是解析 latest 从注册表 每次启动都会保持快速，不会在网络上停滞 版本发布后，服务器在连接时告诉您；将其应用于：

npx @kunobi/mcp upgrade

这将Kunobi注册的每个客户端重新绑定到最新版本 加热缓存。 重新启动AI客户端 加载它（新版本需要 对下一次开始的影响）。

在固定存在之前安装？ 将当前版本固定到位--否 升级，无注册表调用：

npx @kunobi/mcp pin

如果您运行的是旧版本，服务器在检测到连接时也会提示这一点 未固定的配置。用沉默的暗示 MCP_KUNOBI_NO_PIN_HINT=1.

总是喜欢最新的？ 选择退出——每次发布都会解决最新问题 版本再次出现（启动速度较慢，可能会在注册表上停滞）：

npx @kunobi/mcp unpin

手册

如果您更喜欢手动设置，请将以下内容添加到客户端的MCP配置中：

{
  "mcpServers": {
    "kunobi": {
      "command": "npx",
      "args": ["-y", "@kunobi/mcp"]
    }
  }
}

运作原理

AI assistant <--stdio--> @kunobi/mcp <--HTTP--> Kunobi variants
                          │
                          ├── keeps one MCP connection per configured variant
                          ├── retries disconnected variants every 5s
                          └── manages one bundler per variant

服务器为每个配置的Kunobi变体保持持久的MCP连接。当变体可用时，其工具会在 variant__ 前缀（例如。， dev__list_clusters, stable__query_store).当变体短暂下降时，集线器在重新连接到背景的同时保持最后一个已知表面的稳定。如果断开连接超过了重新连接宽限期，则过时的注册将被删除。

多变量支持

Kunobi运送多个在不同港口运行的释放通道。此MCP服务器同时发现所有这些：

这些默认值是自动生成的 ~/.config/kunobi/mcp.json 第一次跑步。您可以添加自定义变量或更改端口——请参阅 配置.

内置工具

即使没有运行Kunobi实例，这些也始终可用：

• kunobi_status --报告所有变体连接状态、端口和工具计数
• kunobi_launch --按名称启动Kunobi变体
• kunobi_refresh --强制所有配置的变体立即重新连接
• kunobi_call --变体工具的稳定入口点(variant, tool, arguments)

推荐的通话模式

使用下面的稳定路径获得最可靠的MCP客户端行为：

1. 呼叫 kunobi_status
2. 阅读 kunobi://tools 发现完整的下游工具模式和元数据
3. 通过执行 kunobi_call(variant, tool, arguments)

动态工具

当检测到Kunobi变体时，其工具会自动显示，并带有变体前缀。例如，如果 dev 和 stable 两者都在运行：

• dev__app_info, dev__query_store, dev__list_stores, ...
• stable__app_info, stable__query_store, stable__list_stores, ...

工具在变体启动时动态显示，只有在持续断开连接后才会被撤回，不需要重新启动MCP服务器。

这些动态 variant__tool 仍然支持条目，但一些MCP客户端可能无法可靠地刷新动态工具列表。使用 kunobi_call 作为有疑问时的主要途径。

资源

Kunobi变体暴露的资源会自动代理。当一个变体连接时，它的资源将通过变体命名空间URI提供给AI客户端，以避免多个正在运行的变体之间的冲突。

服务器还提供内置资源：

• kunobi://status --所有变体连接状态、端口和功能计数的JSON快照。支持订阅--客户端接收 notifications/resources/updated 每当变体连接或断开时。
• kunobi://tools --JSON发现文档列出了每个变体状态以及完整的下游工具、资源和提示元数据 kunobi_call.

提示

Kunobi变体的提示已在 variant__ 前缀（例如。， dev__setup_cluster).它们与变体一起出现和消失，就像工具一样。

配置

配置文件

变量到端口的映射存储在 ~/.config/kunobi/mcp.json （默认情况下，首次运行时自动生成）。您可以直接编辑此文件或使用CLI：

# List all configured variants and their connection status
kunobi-mcp list

# Add a custom variant
kunobi-mcp add juan 4200

# Remove a variant
kunobi-mcp remove juan

环境变量

优先级：配置文件默认值→ MCP_KUNOBI_VARIANTS env-var（在顶部合并）。

命令行界面

kunobi-mcp [command] [options]

发展

pnpm install
pnpm build
pnpm test

为了地方发展反对 @kunobi/mcp-bundler:

pnpm dev:link    # link local bundler
pnpm dev:unlink  # revert to npm version

许可证

阿帕奇-2.0