IG-MCP服务器
项目介绍
Inspektor Gadget MCP Server
使用Inspektor Gadget为Kubernetes集群提供AI驱动的调试和检查。
https://github.com/user-attachments/assets/86367982-c0aa-455c-ac9e-ca43348899df
功能
- 使用AI界面进行Kubernetes故障排除和监控
- 一键部署和移除Inspektor Gadget
- 智能输出汇总和分析
- 自动从Artifact Hub发现小工具
快速开始
- 确保您已安装Docker并具有有效的
kubeconfig文件 - 在VS Code中配置MCP服务器（参见INSTALL.md）
- 开始在VS Code Copilot Chat中使用AI命令
- 尝试："显示DNS流量"或"部署Inspektor Gadget"
- 前往示例获取详细示例。
安装
您可以使用以下命令快速配置Inspektor Gadget MCP服务器，使用Docker或二进制文件在您的VS Code设置中。
Docker
<summary> <details> <summary>安装Inspektor Gadget MCP服务器 - Artifact Hub发现</summary> <pre><code>code --add-mcp '{ "name": "inspektor-gadget", "command": "docker", "args": [ "run", "-i", "--rm", "--volume", "ig-mcp-cache:/root/.cache/ig-mcp-server", "--mount", "type=bind,src=${env:HOME}/.kube/config,dst=/kubeconfig", "ghcr.io/inspektor-gadget/ig-mcp-server:latest", "-gadget-discoverer=artifacthub" ] }'</code></pre> </details> <details> <summary>安装Inspektor Gadget MCP服务器 - 特定小工具</summary> <pre><code>code --add-mcp '{ "name": "inspektor-gadget", "command": "docker", "args": [ "run", "-i", "--rm", "--volume", "ig-mcp-cache:/root/.cache/ig-mcp-server", "--mount", "type=bind,src=${env:HOME}/.kube/config,dst=/kubeconfig", "ghcr.io/inspektor-gadget/ig-mcp-server:latest", "-gadget-images=trace_dns:latest,trace_tcp:latest,snapshot_process:latest,snapshot_socket:latest" ] }'</code></pre> </details> </summary>二进制文件
您可以前往发布页面，下载适用于您平台的最新二进制文件：
<summary> <details> <summary>Linux</summary> <pre><code>MCP_VERSION=$(curl -s https://api.github.com/repos/inspektor-gadget/ig-mcp-server/releases/latest | jq -r .tag_name) MCP_ARCH=amd64 curl -sL https://github.com/inspektor-gadget/ig-mcp-server/releases/download/${MCP_VERSION}/ig-mcp-server-linux-${MCP_ARCH}.tar.gz | sudo tar -C /usr/local/bin -xzf - ig-mcp-server </code></pre> </details> <details> <summary>macOS</summary> <pre><code>MCP_VERSION=$(curl -s https://api.github.com/repos/inspektor-gadget/ig-mcp-server/releases/latest | jq -r .tag_name) MCP_ARCH=arm64 curl -sL https://github.com/inspektor-gadget/ig-mcp-server/releases/download/${MCP_VERSION}/ig-mcp-server-darwin-${MCP_ARCH}.tar.gz | sudo tar -C /usr/local/bin -xzf - ig-m-mp-server </code></pre> </details> <details> <summary>Windows</summary> <pre><code>$MCP_VERSION = (curl.exe -s https://api.github.com/repos/inspektor-gadget/ig-mcp-server/releases/latest | ConvertFrom-Json).tag_name $MCP_ARCH = "amd64" curl.exe -L "https://github.com/inspektor-gadget/ig-mcp-server/releases/download/$MCP_VERSION/ig-mcp-server-windows-$MCP_ARCH.tar.gz" -o "ig-mcp-server.tar.gz" $destPath = "C:\Program Files\ig-mcp-server" if (-Not (Test-Path $destPath -PathType Container)) { mkdir $destPath} tar.exe -xzf "ig-mcp-server.tar.gz" -C "$destPath" rm ig-mcp-server.tar.gz Write-Host "✅ 提取到 $destPath" Write-Host "👉 请手动将'$destPath'添加到您的PATH环境变量中。" </code></pre> </details> </summary>下载后，您可以运行以下命令将其添加到您的VS Code MCP配置中。
<summary> <details> <summary>安装Inspektor Gadget MCP服务器 - Artifact Hub发现</summary> <pre><code>code --add-mcp '{ "name": "inspektor-gadget", "command": "ig-mcp-server", "args": [ "-gadget-discoverer=artifacthub" ] }'</code></pre> </details> <details> <summary>安装Inspektor Gadget MCP服务器 - 特定小工具</summary> <pre><code>code --add-mcp '{ "name": "inspektor-gadget", "command": "ig-mcp-server", "args": [ "-gadget-images=trace_dns:latest,trace_tcp:latest" ] }'</code></pre> </details> </summary>可用工具
Inspektor Gadget生命周期
- ig_deploy: 管理目标Kubernetes集群上Inspektor Gadget的部署
小工具生命周期
- ig_gadgets: 管理正在运行的小工具的生命周期（停止/列表/获取结果）
动态工具
每个小工具都注册为自己的MCP工具（例如，gadget_trace_dns，gadget_trace_tcp等），支持以前景模式运行小工具，这对于调试/开发非常有用，也可以以背景模式运行以实现可观测性。
此外，您可以通过配置MCP服务器的-gadget-discoverer或-gadget-images选项来控制可用的小工具，允许您仅限于所需的工具。
小工具发现
小工具发现允许控制哪些小工具可用。您可以选择两种方法之一：
- 自动: 使用Artifact Hub (
-gadget-discoverer=artifacthub) - 手动: 直接指定小工具 (
-gadget-images=trace_dns:latest)
参见INSTALL.md了解配置选项。
安全注意事项
- 需要对您的kubeconfig文件进行只读访问
- 需要网络访问以进行Artifact Hub发现
- 参见安全指南以最小权限设置服务器
资源
相关项目
- Inspektor Gadget - Kubernetes调试工具
- MCP规范 - 模型上下文协议
许可证
Apache许可证2.0 - 详情请参阅LICENSE。