@gnaws/mcp

Пусть ваш ИИ-агент видит, что скрывается под вашим облаком.

MCP (Model Context Protocol) сервер для @gnaws/core — предоставляет возможности сканирования ресурсов AWS, построения графа и обнаружения неиспользуемых ресурсов в качестве инструментов для ИИ-агентов.

Что это такое?

Это MCP-сервер, который дает ИИ-агентам (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 и не одобрено ими.