本地DevOps工具服务器

一个提供本地DevOps任务的Model Context Protocol (MCP)服务器,使AI助手能够与本地Docker环境、Kubernetes集群和系统日志进行交互。

  • by nguyentrantung205
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 nguyentrantung205/local-devops-mcp

使用说明

本地DevOps MCP服务器

一个模型上下文协议(MCP)服务器,为本地DevOps任务提供工具,使AI助手能够与本地Docker环境、Kubernetes集群和系统日志进行交互。

[!注意] 此服务器使用 TOON(面向令牌的对象表示法) 用于工具输出,以优化LLM的令牌使用。

特性

🐳 码头工人

与本地Docker守护进程交互:

  • docker_list_containers:列出正在运行的容器或所有容器。
  • docker_logs:从容器中获取日志(突出显示错误🔴).
  • docker_restart:重新启动特定容器。
  • docker_inspect:检查集装箱细节。

☸️ Kubernetes

与本地Kubernetes集群交互(使用 ~/.kube/config):

  • k8s_list_pods:列出命名空间中的Pod。
  • k8s_pod_logs:从pod中获取日志。
  • k8s_describe_pod:获取详细的pod信息。

🖥️ 系统

访问本地系统信息:

  • system_open_ports:列出打开的侦听端口(需要 lsof).
  • system_logs:读取系统日志(例如。, /var/log/system.log).

安装与使用

使用 npx (推荐)

您可以直接运行服务器,无需安装:

npx local-devops-mcp

Claude桌面配置

要将此服务器与Claude Desktop一起使用,请将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "local-devops": {
      "command": "npx",
      "args": ["-y", "local-devops-mcp"]
    }
  }
}

从源头运行

  1. 克隆存储库:
    git clone https://github.com/nguyentrantung205/local-devops-mcp.git
    cd local-devops-mcp
    
  2. 安装依赖项:
    npm install
    
  3. 构建项目:
    npm run build
    
  4. 运行服务器:
    node build/index.js
    

先决条件

  • Node.js:v18或更高版本。
  • 码头工人:Docker桌面或Docker引擎必须在本地运行。
  • Kubernetes: kubectl 配置了有效的 ~/.kube/config (可选,仅适用于K8s工具)。
  • 权限:运行服务器的用户需要访问Docker套接字和读取系统日志的权限。

测试

看 测试.md 有关如何在本地测试服务器的说明。

许可证

ISC