@gnaws/mcp

あなたのクラウドの内側をAIエージェントに見せましょう。

@gnaws/core のためのMCP（Model Context Protocol）サーバー — AWSリソースのスキャン、グラフ構築、未使用リソース検出をAIエージェント向けのツールとして公開します。

これは何ですか？

AIエージェント（Claude、Kiro、Cursorなど）に以下の機能を提供するMCPサーバーです：

• スキャン — 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との提携や推奨はありません。