@gnaws/mcp

让你的AI代理看清云层之下的世界。

用于 @gnaws/core 的 MCP（模型上下文协议）服务器——将 AWS 资源扫描、图谱构建和未使用资源检测作为工具提供给 AI 代理。

这是什么？

一个 MCP 服务器，让 AI 代理（Claude、Kiro、Cursor 等）能够：

• 扫描你的 AWS 账户并构建资源关系图谱

• 加载之前转储的数据以进行离线分析

• 检测未使用/孤立的资源（分离的卷、未关联的 IP、空负载均衡器等）

• 导出图谱为 GEXF（Gephi）、JSON（sigma.js）或 Markdown 格式

• 转储原始资源数据以供后续使用

Related MCP server: AWS SRA Verify MCP Server

安装

npm install -g @gnaws/mcp
# or run without installing:
npx @gnaws/mcp

需要 Node.js >= 24。

MCP 客户端配置

Kiro

添加到 .kiro/settings/mcp.json：

{
  "mcpServers": {
    "gnaws": {
      "command": "npx",
      "args": ["@gnaws/mcp"]
    }
  }
}

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "gnaws": {
      "command": "npx",
      "args": ["@gnaws/mcp"]
    }
  }
}

VS Code（GitHub Copilot）

添加到 .vscode/mcp.json：

{
  "servers": {
    "gnaws": {
      "command": "npx",
      "args": ["@gnaws/mcp"]
    }
  }
}

Cursor

添加到 .cursor/mcp.json（项目）或 ~/.cursor/mcp.json（全局）：

{
  "mcpServers": {
    "gnaws": {
      "command": "npx",
      "args": ["@gnaws/mcp"]
    }
  }
}

可用工具

示例对话

用户： 显示我 AWS 账户中未使用的资源 代理： 调用 scan（使用配置文件）→ 调用 detect → 呈现结果

用户： 从 ./data 加载转储并导出图谱 代理： 调用 load（指定路径）→ 调用 export（格式为 "gexf"）

用户： gnaws 服务器的状态如何？ 代理： 调用 status → 报告未加载数据，建议执行 scan 或 load

特性

• 进度通知 — 长时间运行的扫描会向代理报告进度

• 错误处理 — 每个工具都返回结构化错误并附带可操作的建议

• 工作流引导 — 工具响应会告诉代理下一步该调用什么

• 离线模式 — 无需 AWS 凭证即可从转储加载

• 65+ 个 AWS 服务 — EC2、Lambda、S3、RDS、ECS、EKS、DynamoDB 等

日志级别

所有日志输出到 stderr（对 MCP stdio 传输安全）。通过以下方式控制详细程度：

LOG_LEVEL=debug npx @gnaws/mcp

可用级别：debug、info、warn、error、silent（默认：info）。

开发

# Build
npm run build

# Dev mode (tsx with hot reload)
npm run dev

# Type-check
npm run typecheck

# Lint
npm run lint

# Test with MCP Inspector
npx @modelcontextprotocol/inspector npx @gnaws/mcp

贡献

参见 CONTRIBUTING.md。

支持

如果 GNAWS 帮你节省了 AWS 账单费用，请考虑赞助该项目。

许可证

AGPL-3.0 — 参见 LICENSE。

与 Amazon Web Services 无关联或未经其认可。