Ig Mcp Server

开发 Go

🚀 Inspektor Gadget MCP Server

Inspektor Gadget MCP Server 借助人工智能技术，为 Kubernetes 集群提供调试和检查功能，帮助用户更高效地排查和监控集群问题。

🚀 快速开始

确保你已经安装了 Docker 并拥有有效的 kubeconfig 文件。
在 VS Code 中配置 MCP 服务器（详见 INSTALL.md）。
在 VS Code Copilot Chat 中开始使用 AI 命令。
你可以尝试输入："Show me DNS traffic" 或 "Deploy Inspektor Gadget"。
前往 examples 查看详细示例。

✨ 主要特性

人工智能驱动的 Kubernetes 故障排查与监控界面：利用人工智能技术，提供智能的故障排查和监控能力。
一键部署和移除 Inspektor Gadget：简化 Inspektor Gadget 的部署和移除流程。
智能输出总结与分析：对输出结果进行智能总结和分析，帮助用户快速理解关键信息。
自动从 Artifact Hub 发现工具：自动发现可用的工具，方便用户使用。

📦 安装指南

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

Docker

安装 Inspektor Gadget MCP 服务器 - Artifact Hub 发现模式

```bash code --add-mcp '{ "name": "inspektor-gadget", "command": "docker", "args": [ "run", "-i", "--rm", "--mount", "type=bind,src=${env:HOME}/.kube/config,dst=/kubeconfig", "ghcr.io/inspektor-gadget/ig-mcp-server:latest", "-gadget-discoverer=artifacthub" ] }' ```

安装 Inspektor Gadget MCP 服务器 - 指定工具模式

二进制文件

你可以前往 Releases 页面，下载适合你平台的最新二进制文件：

Linux

```bash 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

```bash 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

```powershell $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 配置中。

安装 Inspektor Gadget MCP 服务器 - Artifact Hub 发现模式

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

安装 Inspektor Gadget MCP 服务器 - 指定工具模式

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

📚 详细文档

可用工具

管理工具

is_inspektor_gadget_deployed：检查 Inspektor Gadget 是否已部署到你的集群中。
deploy_inspektor_gadget：在你的集群中安装 Inspektor Gadget（如果设置了 -read-only 则跳过）。
undeploy_inspektor_gadget：从你的集群中移除 Inspektor Gadget（如果设置了 -read-only 则跳过）。

生命周期工具

stop-gadget：停止一个后台运行的工具。
get-results：从一个后台运行的工具中获取结果。
wait：等待一个工具运行完成。

动态工具

每个工具都作为独立的 MCP 工具进行注册（例如 trace_dns、trace_tcp 等），支持在前台模式下运行工具，这对于调试/开发很有用，也支持在后台模式下运行以进行可观测性监控。

此外，你可以通过使用 -gadget-discoverer 或 -gadget-images 选项配置 MCP 服务器来控制可用的工具，从而将工具限制为仅你需要的工具。

工具发现

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

自动发现：使用 Artifact Hub (-gadget-discoverer=artifacthub)。
手动指定：直接指定工具 (-gadget-images=trace_dns:latest)。

详见 INSTALL.md 了解配置选项。

🔧 技术细节

安全注意事项

需要对 kubeconfig 文件具有只读访问权限。
需要网络访问权限以进行 Artifact Hub 发现。
详见 security guide 了解如何使用最小权限设置服务器。

资源链接

📖 文档
🔍 示例
🐛 问题反馈
💬 Slack 交流
🌐 官方网站
📋 故障排除
🔒 安全指南

📄 许可证

本项目采用 Apache License 2.0 许可证，详情请见 LICENSE。

0 条评论
分类：开发