acuvity/mcp-server-kubernetes

您可以使用以下"一键式"链接立即开始：

全局范围

按下ctrl + shift + p并输入Preferences: Open User Settings JSON，添加以下部分：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-kubernetes": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--read-only",
          "docker.io/acuvity/mcp-server-kubernetes:3.2.0"
        ]
      }
    }
  }
}

工作区范围

在您的工作区中创建一个名为.vscode/mcp.json的文件，并添加以下部分：

json
{
  "servers": {
    "acuvity-mcp-server-kubernetes": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--read-only",
        "docker.io/acuvity/mcp-server-kubernetes:3.2.0"
      ]
    }
  }
}

要传递秘密信息，您应使用Visual Studio Code文档中描述的promptString输入类型。

在~/.codeium/windsurf/mcp_config.json中添加以下部分：

json
{
  "mcpServers": {
    "acuvity-mcp-server-kubernetes": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--read-only",
        "docker.io/acuvity/mcp-server-kubernetes:3.2.0"
      ]
    }
  }
}

有关更多信息，请参见Windsurf文档。

将以下JSON块添加到您的mcp配置文件：

• 全局范围：~/.cursor/mcp.json
• 项目范围：.cursor/mcp.json

json
{
  "mcpServers": {
    "acuvity-mcp-server-kubernetes": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--read-only",
        "docker.io/acuvity/mcp-server-kubernetes:3.2.0"
      ]
    }
  }
}

有关更多信息，请参见cursor文档。

在claude_desktop_config.json配置文件中添加以下部分：

json
{
  "mcpServers": {
    "acuvity-mcp-server-kubernetes": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--read-only",
        "docker.io/acuvity/mcp-server-kubernetes:3.2.0"
      ]
    }
  }
}

有关更多信息，请参见Anthropic文档。

本地运行

python
async with MCPServerStdio(
    params={
        "command": "docker",
        "args": ["run","-i","--rm","--read-only","docker.io/acuvity/mcp-server-kubernetes:3.2.0"]
    }
) as server:
    tools = await server.list_tools()

远程运行

python
async with MCPServerSse(
    params={
        "url": "http://<ip>:<port>/sse",
    }
) as server:
    tools = await server.list_tools()

有关更多信息，请参见https://openai.github.io/openai-agents-python/mcp/%E3%80%82

在您的客户端配置中设置：

• 命令：docker
• 参数：run -i --rm --read-only docker.io/acuvity/mcp-server-kubernetes:3.2.0

直接运行：

console
docker run -it -p 8000:8000 --rm --read-only docker.io/acuvity/mcp-server-kubernetes:3.2.0

然后在您的应用程序/客户端中，您可以配置为使用：

json
{
  "mcpServers": {
    "acuvity-mcp-server-kubernetes": {
      "url": "http://localhost:8000/sse"
    }
  }
}

您可能需要为不同工具使用不同的端口。

本节假设您熟悉TLS和证书，需要：

• 具有与工具部署匹配的正确DNS/IP字段的服务器证书。
• 用于签署客户端证书的客户端CA。

1. 以backend模式启动服务器：

• 添加环境变量：-e MINIBRIDGE_MODE=backend
• 通过卷添加TLS证书（推荐），例如/certs：-v $PWD/certs:/certs
• 指示minibridge使用这些证书：
  • -e MINIBRIDGE_TLS_SERVER_CERT=/certs/server-cert.pem
  • -e MINIBRIDGE_TLS_SERVER_KEY=/certs/server-key.pem
  • -e MINIBRIDGE_TLS_SERVER_KEY_PASS=optional（可选）
  • -e MINIBRIDGE_TLS_SERVER_CLIENT_CA=/certs/client-ca.pem

2. 在本地以前端模式启动minibridge：

• 获取适用于您操作系统的https://github.com/acuvity/minibridge%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6%E3%80%82

在您的客户端配置中，Minibridge像任何其他STDIO命令一样工作。

Claude Desktop示例：

json
{
  "mcpServers": {
    "acuvity-mcp-server-kubernetes": {
      "command": "minibridge",
      "args": ["frontend", "--backend", "wss://<remote-url>:8000/ws", "--tls-client-backend-ca", "/path/to/ca/that/signed/the/server-cert.pem/ca.pem", "--tls-client-cert", "/path/to/client-cert.pem", "--tls-client-key", "/path/to/client-key.pem"]
    }
  }
}

就是这样。

Minibridge提供了许多额外功能。如需分步指南，请访问wiki。如有任何不清楚的地方，请随时联系我们！

安装方法

您可以查看图表的README：

console
helm show readme oci://docker.io/acuvity/mcp-server-kubernetes --version 1.0.0

您可以查看可配置的 values：

CODE_TOKEN_11`

使用Helm安装：

console
helm install mcp-server-kubernetes oci://docker.io/acuvity/mcp-server-kubernetes --version 1.0.0

默认情况下，您的MCP服务器mcp-server-kubernetes可以通过集群内部的Kubernetes服务mcp-server-kubernetes在端口8000上通过http/sse访问。您可以通过查看values.yaml文件的service部分进行更改。

监控方法

部署将创建一个带有healthPort的Kubernetes服务，用于活性探针和就绪探针。此健康端口也可用于您选择的监控堆栈，并在/metrics路径下公开指标。

有关设置和运行时安全（包括防护措施激活）的更多详细信息，请参见完整的图表https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-kubernetes/charts/mcp-server-kubernetes/README.md%E3%80%82