Inspektor Gadget MCP Server

检查器小工具MCP服务器

使用Inspektor Gadget对Kubernetes集群进行AI驱动的调试和检查。

https://github.com/user-attachments/assets/86367982-c0aa-455c-ac9e-ca43348899df

特性

• 用于Kubernetes故障排除和监控的人工智能接口
• 一键Inspektor小工具部署和删除
• 智能输出汇总与分析
• 从Artifact Hub自动发现小工具

快速开始

1. 确保你有Docker和有效的 kubeconfig 文件
2. 在VS代码中配置MCP服务器（请参阅 安装.md)
3. 开始在VS Code Copilot聊天中使用AI命令
4. 尝试：“显示DNS流量”或“部署Inspektor小工具”
5. 前往 示例 以获取详细示例。

安装

您可以使用以下命令使用Docker或VS Code设置中的二进制文件快速配置Inspektor Gadget MCP服务器。

Kubernetes

要使用IG MCP Server，您需要使用以下命令之一部署Inspektor Gadget：

IG_VERSION=$(curl -s https://api.github.com/repos/inspektor-gadget/inspektor-gadget/releases/latest | jq -r '.tag_name' | sed 's/^v//')
helm install gadget --namespace=gadget --create-namespace oci://ghcr.io/inspektor-gadget/inspektor-gadget/charts/gadget --version=$IG_VERSION

或

IG_VERSION=$(curl -s https://api.github.com/repos/inspektor-gadget/inspektor-gadget/releases/latest | jq -r '.tag_name')
kubectl apply -f https://github.com/inspektor-gadget/inspektor-gadget/releases/download/${IG_VERSION}/inspektor-gadget-${IG_VERSION}.yaml

然后，您可以使用以下命令将IG MCP服务器部署到Kubernetes集群：

kubectl apply -f https://raw.githubusercontent.com/inspektor-gadget/ig-mcp-server/main/manifests/ig-mcp-server-all.yaml

然后使用以下命令将服务器端口转发到本地计算机：

kubectl port-forward svc/ig-mcp-server 8080:8080 -n gadget

然后你可以使用 http://localhost:8080/mcp 作为代理中的远程MCP url（传输：http）。

安全说明：IG MCP服务器当前未实现内置身份验证。对于生产部署，强烈建议将服务器放置在具有正确身份验证和TLS终止的反向代理（如nginx、Traefik或API网关）之后。此外，确保服务不直接暴露在互联网上，并使用网络策略仅限制对可信来源的访问。

码头工人

Install Inspektor Gadget MCP Server - Artifact Hub Discovery

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" ] }'

Install Inspektor Gadget MCP Server - Specific Gadgets

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" ] }'

二进制

您可以前往 发布 页面并下载适用于您平台的最新二进制文件：

Linux

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

macOS

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-mcp-server

Windows

$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 "✅ Extracted to $destPath" Write-Host "👉 Please add '$destPath' to your PATH environment variable manually."

下载后，您可以运行以下命令将其添加到VS Code MCP配置中。

Install Inspektor Gadget MCP Server - Artifact Hub Discovery

code --add-mcp '{ "name": "inspektor-gadget", "command": "ig-mcp-server", "args": [ "-gadget-discoverer=artifacthub" ] }'

Install Inspektor Gadget MCP Server - Specific Gadgets

code --add-mcp '{ "name": "inspektor-gadget", "command": "ig-mcp-server", "args": [ "-gadget-images=trace_dns:latest,trace_tcp:latest" ] }'

可用工具

检查器小工具生命周期

• ig_部署：管理Inspektor Gadget在目标Kubernetes集群上的部署

小工具生命周期

• ig_gadgets：管理正在运行的小工具的生命周期（停止/列出/获取结果）

动态工具

每个小工具被注册为其自己的MCP工具（例如。， gadget_trace_dns, gadget_trace_tcp等），并支持在前台模式下运行小工具，这对调试/开发很有用，在后台模式下也可用于可观察性。

此外，您可以通过配置MCP服务器来控制哪些小工具可用 -gadget-discoverer 或 -gadget-images 选项，允许您将工具限制为仅需要的工具。

小工具发现

小工具发现允许控制哪些小工具可供使用。您可以在两种方法之间进行选择：

• 自动：使用工件中心(-gadget-discoverer=artifacthub)
• 手册：直接指定小工具(-gadget-images=trace_dns:latest)

看 安装.md 用于配置选项。

安全说明

• 需要只读访问kubeconfig文件
• 需要网络访问权限才能发现Artifact Hub
• 看 安全指南 用于设置具有最小权限的服务器

资源

• 📖 文档
• 🔍 例子
• 🐛 问题
• 💬 Slack
• 🌐 网站
• 📋 故障排除
• 🔒 安全指南

相关项目

• 神探加杰特 -Kubernetes调试工具
• MCP规范 -模型上下文协议

许可证

Apache许可证2.0-请参阅 许可证 了解详情。