K0rdent MCP Server

MCPAI代理

提供方 randybias

AI代理 未标注 无需鉴权 社区 / 第三方 Claude

一个实验性的MCP服务器,通过模型上下文协议向AI助手暴露k0rdent集群管理能力,适用于k0rdent开发者和早期采用者探索MCP集成。

一句话选型结论

按资料字段整理

K0rdent MCP Server 属于AI代理类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

集群管理Go本地部署AI助手开发工具实验性

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
K0rdent MCP Server当前 未标注 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方randybias上游标注的维护方 randybias
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

12.9 KB
来自项目仓库与上游目录的原文,未做删改

k0rdent MCP服务器

⚠️ 实验开发工具 –早期阶段,预计问题

🚧 仅限本地主机 –无TLS,需要管理员kubeconfig

🤖 在人工智能的帮助下开发 –代码质量和安全尚未准备好投入生产

使用风险自负

您使用此实验性MCP服务器的风险由您自行承担。Randy Bias和Mirantis,股份有限公司均不对您的使用承担任何责任。这是使用AI代理通过MCP协议控制k0rdent管理和子集群的概念验证。它绝对没有准备好生产。

这是什么

一个实验性的MCP服务器,通过模型上下文协议向AI助手公开k0rdent集群管理功能。这是一个 开发工具 适用于希望探索MCP集成而非生产就绪解决方案的k0rdent开发人员和早期采用者。

要点:

  • 仅在本地主机上运行(不支持TLS)
  • 需要管理员kubeconfig到现有的k0rdent管理集群
  • 不为您提供管理集群
  • 在人工智能的帮助下构建-代码质量需要提高
  • 提供商支持各不相同:Azure已测试,AWS最低,GCP未测试

这不是什么

  • ❌ 可生产的
  • ❌ 不是独立工具(需要现有的k0rdent集群)
  • ❌ 网络暴露不安全(仅限本地主机)
  • ❌ 未在所有提供商中进行全面测试
  • ❌ 不适用于RBAC受限环境(需要管理员访问权限)

先决条件(全部必填)

在开始之前,您必须:

  1. 现有的k0rdent管理集群 这个工具不会为你创建一个。您需要一个正在运行的k0rdent安装。
  2. 管理员kubeconfig –需要完全访问群集。未测试RBAC限制。
  3. 转到1.24+ –从源代码构建。
  4. MCP兼容客户端 –克劳德桌面推荐。
  5. 知识 –了解集群部署、ServiceTemplates、凭据等。
  6. 本地主机部署 -没有远程访问,没有TLS。

已知限制和问题

使用前请仔细阅读本节内容:

提供商支持

  • 谷歌云平台:未经测试,可能根本不起作用
  • Azure:有效,但需要手动订阅ID参数(未自动检测)
  • 亚马逊云服务:测试最少,预计会出现问题

身份验证和安全

  • 仅限管理员kubeconfig –没有OIDC支持,没有RBAC强制
  • AI辅助代码 –未经安全审查,使用风险自负
  • 仅限本地主机 –无TLS,仅在127.0.0.1上运行
  • 无身份验证模式 –仅基于kubeconfig的访问

功能差距

  • 目录操作 –同步可能有错误
  • 并行操作 –比赛条件可能
  • 错误恢复 –可能会留下孤立的云资源
  • 资源清理 –不保证故障

部署警告

  • 创建真正的云资源 –成本适用于您的云帐户
  • 可能留下孤儿 –失败的部署可能无法完全清理
  • 实验性 –预计崩溃和意外行为

快速入门(实验)

  1. 克隆存储库```bash
    git clone https://github.com/randybias/k0rdent-mcp-server.git
    cd k0rdent-mcp-server

1. **构建服务器**```bash
go build -o server cmd/server/main.go
  1. 设置所需的环境变量```bash

Required: Point to your k0rdent cluster kubeconfig

export K0RDENT_MGMT_KUBECONFIG_PATH=/path/to/admin-kubeconfig

Optional: Override default (defaults to 127.0.0.1:6767 for security)

export LISTEN_ADDR=127.0.0.1:3000

Optional: Set log level

export LOG_LEVEL=debug


1. **启动服务器**```bash
./server start
  1. 配置Claude代码 (详见下文说明)

  2. 先尝试安全操作

  • 列出命名空间(最安全)
  • 列出集群模板
  • 列出凭据

警告:集群部署操作将创建真正的云资源并产生成本。

Claude代码设置

安装

  1. 安装Claude代码 (如果尚未安装)
  • Claude代码快速入门
  1. 配置MCP服务器连接

将k0rdent MCP服务器添加到您的Claude Code配置中:

  • 最简单的方法是使用 克劳德mcp命令 从CLI。
  1. 启动k0rdent MCP服务器
  • 如上文快速入门所示
  1. 启动克劳德代码 并验证连接```bash
    claude

1. **克劳德代码与MCP**

- Claude Code中的mcp命令将带您到达需要去的地方:```bash
/mcp

提示:如果您重新启动服务器,则需要使用 /mcp 命令。

示例用法

连接后,您可以使用自然语言与您的k0rdent集群进行交互:

安全勘探命令```

"List all namespaces in the management cluster"
"Show me all available cluster templates"
"What credentials are configured for Azure?"
"List all cluster deployments"


#### 集群部署示例```
"Deploy a new Azure cluster named 'dev-cluster' in eastus region using Standard_D2s_v3 VMs"

"Create an AWS cluster with 3 control plane nodes and 5 workers in us-west-2"

"Show me the provisioning status of cluster 'prod-cluster' in namespace 'kcm-system'"

服务管理示例```

"List all ServiceTemplates available in the catalog"

"Install the ingress-nginx ServiceTemplate from the catalog"

"Apply the monitoring ServiceTemplate to cluster 'dev-cluster'"

"What services are currently running on cluster 'prod-cluster'?"


#### 监控和故障排除```
"Subscribe to provisioning updates for cluster 'dev-cluster' in namespace 'kcm-system'"

"Show me recent events in the kcm-system namespace"

"Get logs from pod 'controller-manager-xyz' in namespace 'kcm-system'"

"What's the current state of my cluster deployment 'staging-cluster'?"

清理```

"Delete cluster 'dev-cluster' from namespace 'kcm-system'"

"Remove the test-cluster and wait for deletion to complete"


### 与Claude代码一起使用的提示

- **从只读操作开始** 熟悉集群状态
- **使用自然语言** Claude Code理解意图,而不仅仅是命令
- **请求确认** 关于破坏性操作(克劳德代码会提示您)
- **监控成本** –集群部署创建真正的云资源
- **使用订阅** 用于长时间运行的操作,如集群配置
- **检查群集状态** 手术前后 `getState` 工具

## 什么有效(最低限度测试)

这些功能已经过测试,应该可以正常工作:

- **Azure群集部署** –如果您提供订阅ID,则有效
- **集群监控** –通过订阅配置进度 `k0rdent://cluster-monitor/{namespace}/{name}`
- **命名空间操作** -列出命名空间和基本K8s操作
- **事件流** –通过以下方式查看命名空间事件 `k0rdent://events/{namespace}`
- **Pod日志** –尾箱日志通过 `k0rdent://podlogs/{namespace}/{pod}/{container}`
- **服务附件** –将ServiceTemplates附加到正在运行的集群(需要更多测试)
- **凭据管理** –列出提供商凭据

## 什么是未经测试或损坏的

这些功能可能不起作用:

- **GCP部署** –完全未经测试,可能已损坏
- **AWS部署** –测试最少,可能有问题
- **目录操作** –同步中的已知错误
- **非管理员访问** –未实现RBAC过滤
- **并行操作** –比赛条件可能
- **错误恢复** –可能会不顺利地失败
- **资源清理** –失败时可能出现孤立资源

## 配置

服务器完全通过环境变量配置(无配置文件):

### 必需变量```bash
# Kubeconfig path (required)
export K0RDENT_MGMT_KUBECONFIG_PATH=/path/to/kubeconfig

可选变量```bash

Server configuration

export LISTEN_ADDR=127.0.0.1:6767 # Listen address (default: 127.0.0.1:6767)

Use 0.0.0.0:6767 to bind to all interfaces (NOT RECOMMENDED - no TLS)

export AUTH_MODE=DEV_ALLOW_ANY # Auth mode (default: DEV_ALLOW_ANY)

Options: DEV_ALLOW_ANY, OIDC_REQUIRED

Kubernetes configuration

export K0RDENT_MGMT_CONTEXT=my-context # Override kubeconfig context
export K0RDENT_NAMESPACE_FILTER='^kcm-.*' # Namespace filter regex

Logging configuration

export LOG_LEVEL=info # Log level (debug, info, warn, error)
export LOG_EXTERNAL_SINK_ENABLED=false # Enable external JSON logging

Cluster provisioning defaults

export CLUSTER_GLOBAL_NAMESPACE=kcm-system # Global namespace (default: kcm-system)
export CLUSTER_DEFAULT_NAMESPACE_DEV=kcm-system # Dev mode namespace
export CLUSTER_DEPLOY_FIELD_OWNER=mcp.clusters # Server-side apply owner
```

备注:未使用config.yaml文件。所有配置都是通过环境变量或命令行标志进行的(--listen, --debug, --log-level).

工具概述

服务器公开了以下MCP工具:

工具名称 用途 状态
群集管理
k0rdent.mgmt.clusterDeployments.list 列出所有群集部署 有效
k0rdent.mgmt.clusterDeployments.listAll 使用选择器列出集群部署 有效
k0rdent.mgmt.clusterDeployments.getState 获取包括服务在内的群集状态(WIP) 有效
k0rdent.mgmt.clusterDeployments.delete 删除群集部署 有效
k0rdent.provider.aws.clusterDeployments.deploy 将子集群部署到AWS提供商 最少的测试
k0rdent.provider.azure.clusterDeployments.deploy 将子群集部署到Azure提供程序 已测试,需要subscriptionID
k0rdent.provider.gcp.clusterDeployments.deploy 将子集群部署到GCP提供程序 未测试
服务模板和服务管理
k0rdent.mgmt.clusterDeployments.services.apply 将ServiceTemplate应用于集群 大部分工作;可能是边缘情况;不处理参数
k0rdent.mgmt.serviceTemplates.list 列出已安装的ServiceTemplates管理服务器 工作
k0rdent.mgmt.serviceTemplates.install_from_catalog 从目录将ServiceTemplate安装到管理服务器 可能有错误;大部分测试
k0rdent.mgmt.serviceTemplates.delete 从管理服务器中删除ServiceTemplate 工作
k0rdent.mgmt.multiClusterServices.list 列出多集群服务 未测试
目录操作
k0rdent.catalog.serviceTemplates.list 列表目录ServiceTemplates Works
提供商和凭据
k0rdent.mgmt.providers.list 列出基础设施提供商 有效
k0rdent.mgmt.providers.listCredentials 列出提供程序凭据 有效
k0rdent.mgmt.providers.listIdentities 列出ClusterIdentity资源 工作
群集模板
k0rdent.mgmt.clusterTemplates.list 列出集群模板 有效
Kubernetes操作
k0rdent.mgmt.namespaces.list 列出命名空间 有效
k0rdent.mgmt.events.list 列出命名空间事件 有效
k0rdent.mgmt.podLogs.get 获取pod日志 有效

MCP资源(订阅)

服务器还提供流媒体资源(大部分未经测试):

资源URI 目的 状态
k0rdent://cluster-monitor/{namespace}/{name} 流式群集配置更新 已在Azure上测试
k0rdent://events/{namespace} 流命名空间事件 有效
k0rdent://podlogs/{namespace}/{pod}/{container} 流式吊舱日志 有效

有关详细的工具文档,请参阅 docs/ 目录。

文档

  • 群集资源调配 –部署工作流(Azure焦点)
  • 提供商特定工具 –每个提供商的部署详细信息
  • 集群监控 –实时配置更新
  • 目录操作 –安装服务模板
  • 现场测试 –测试剧本以进行验证
  • 故障排除指南 –常见问题和解决方案
  • 贡献指南 –开发工作流程和OpenSpec流程
  • 开发设置 当地发展环境

有关拟议的更改和规范,请参阅 openspec/ 目录或运行 openspec list.

贡献

这个实验项目是在人工智能的帮助下建立的。代码质量和安全性需要改进。欢迎捐款,特别是:

  • 测试GCP和AWS部署路径
  • 修复目录同步错误
  • 改进错误处理和恢复
  • 添加适当的RBAC支持
  • 安全审查和强化
  • 修复AI生成的代码问题
  • 为未测试的代码路径编写测试

看 贡献.md 了解OpenSpec工作流程和开发指南。

安全与免责声明

使用前请阅读以下内容:

  • ⚠️ 可生产的 –实验软件,使用风险自负
  • ⚠️ AI辅助代码 –可能包含安全漏洞
  • ⚠️ 需要管理员权限 –没有RBAC强制,假设完全访问集群
  • ⚠️ 仅限本地主机 –没有TLS,对网络暴露不安全
  • ⚠️ 创建真正的云资源 –费用适用于您的账户
  • ⚠️ 可能会留下孤儿资源 –失败的操作可能无法清理
  • ⚠️ 无担保 –使用风险自负

建议:

  • 仅使用非生产集群
  • 部署前设置云成本警报
  • 运营后审查云资源
  • 确保管理员kubeconfig的安全
  • 不要将服务器暴露在网络中

路线图(也许)

未来可能的改进(无承诺):

  • 修复并测试GCP部署路径
  • 稳定AWS部署
  • 修复目录同步错误
  • 添加RBAC支持(非管理员访问)
  • 为远程访问添加TLS支持
  • 安全审查和强化
  • 生产部署选项
  • 改进了错误处理和恢复

看 openspec list 详细的拟议变更。

获取帮助

  • 问题: https://github.com/randybias/k0rdent-mcp-server/issues
  • 讨论: https://github.com/randybias/k0rdent-mcp-server/discussions
  • k0rdent文档: https://docs.k0rdent.io
  • MCP协议: https://modelcontextprotocol.io

有关开发问题,请参阅 贡献.md.

许可证

[在此处添加许可证信息]

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
K0rdent MCP Server 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

K0rdent MCP Server 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

K0rdent MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

K0rdent MCP Server 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

K0rdent MCP Server 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

K0rdent MCP Server 能提供哪些能力?

资料显示能力标签包括 集群管理、开发工具、Go、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。