@gnaws/mcp

당신의 AI 에이전트가 클라우드 아래를 볼 수 있게 하세요.

MCP (Model Context Protocol) 서버로, @gnaws/core를 위한 것입니다. 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 호출 → 형식 "gexf"로 export 호출

사용자: 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와 제휴하거나 보증하지 않습니다.