mcp-greynoise

GreyNoise API용 MCP 서버 — IP 주소가 인터넷 배경 소음인지, 아니면 잠재적 표적 공격인지 확인합니다.

빠른 시작

npx mcp-greynoise

이것으로 끝입니다. 별도의 설정 없이 하루 10회 조회가 가능합니다(API 키 불필요).

Related MCP server: MCP AbuseIPDB Server

GreyNoise란?

GreyNoise는 인터넷 전체의 스캔 트래픽을 수집하고 분석합니다. 다음을 알려줍니다:

• Noise: 이 IP가 인터넷을 대규모로 스캔하고 있나요? (봇넷, 연구자, 크롤러)

• RIOT: 이 IP가 알려진 정상 서비스인가요? (Google, Cloudflare, Microsoft 등)

• Classification: 악성, 정상 또는 알 수 없음

이것이 보안에서 중요한 이유

로그에서 의심스러운 트래픽을 발견했을 때:

"NOT NOISE" 사례가 가장 중요한 경우가 많습니다 — 이는 누군가가 특별히 사용자의 시스템에 관심을 갖고 있음을 시사합니다.

데모

check_ip 출력 예시:

IP: 51.91.185.74
Classification: MALICIOUS
Noise: YES - This IP has been observed scanning the internet
RIOT: NO - Not a known benign service IP
Last Seen: 2024-01-15
Details: https://viz.greynoise.io/ip/51.91.185.74

--- Interpretation ---
🚨 This IP is actively scanning the internet and classified as MALICIOUS. 
   Likely a scanner, botnet, or threat actor.

설치

npm(권장)

npm install -g mcp-greynoise

npx(설치 불필요)

npx mcp-greynoise

소스에서 설치

git clone https://github.com/nickjlucker/mcp-greynoise.git
cd mcp-greynoise
npm install
npm run build
node build/index.js

설정

Claude Desktop

claude_desktop_config.json에 추가하세요:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "greynoise": {
      "command": "npx",
      "args": ["mcp-greynoise"],
      "env": {
        "GREYNOISE_API_KEY": "your-api-key-here"
      }
    }
  }
}

환경 변수

무료 API 키는 viz.greynoise.io/signup에서 받을 수 있습니다.

⚠️ API 키를 커밋하지 마세요. 권장 설정은 .env.example을 참조하세요.

도구

check_ip

단일 IP 주소를 GreyNoise에 조회합니다.

입력:

• ip (string): 조회할 IPv4 주소

check_ips

한 번의 호출로 여러 IP 주소를 조회합니다(최대 10개).

입력:

• ips (string[]): IPv4 주소 배열

출력 예시:

=== Results ===
8.8.8.8: RIOT (benign service) [Google]
51.91.185.74: NOISE - MALICIOUS
192.168.1.1: NOT NOISE (potentially targeted)

--- Legend ---
RIOT: Known benign service (CDN, DNS, etc.)
NOISE: IP is mass-scanning the internet
NOT NOISE: IP is NOT mass-scanning (traffic may be targeted)

리소스

greynoise://status

API 상태 및 요청 한도 정보를 반환합니다.

요청 한도

요청 한도는 API 호출과 GreyNoise Visualizer 간에 공유됩니다.

보안

이 서버는:

• GreyNoise API에서 읽기만 수행합니다(스캔 없음, 악용 없음)

• 현재 요청 외의 데이터를 저장하지 않습니다

• 사용자의 API 키를 GreyNoise 외의 어디에도 전송하지 않습니다

• 평판/텔레메트리 보강만 수행합니다

사용자의 API 키는 환경 변수를 통해 전달되며 절대 기록되지 않습니다.

사용 사례

• SOC 트라이지: 알림 IP가 배경 소음인지 표적 공격인지 신속하게 판단합니다

• 침해 대응: 공격자 IP가 대규모 스캐너인지 집중형 위협인지 식별합니다

• 위협 헌팅: 로그에서 대규모 스캐너가 아닌 IP(잠재적 표적)를 찾아냅니다

• 로그 분석: 알려진 스캐너를 필터링하여 오탐지를 줄입니다

개발

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run built version
npm start

라이선스

MIT

링크

• GreyNoise

• GreyNoise API 문서

• Model Context Protocol

• MCP Registry