Threat Intel MCP 서버

Claude를 위한 위협 인텔리전스 및 취약점 연구 도구를 제공하는 FastMCP 서버입니다. NVD, VirusTotal, AbuseIPDB, Shodan 및 MITRE ATT&CK과 통합됩니다.

도구

Related MCP server: Exploit Intel Platform MCP Server

설정

1. 가상 환경 생성 및 활성화:

python -m venv venv
.\venv\Scripts\Activate.ps1

2. 의존성 설치:

pip install -r requirements.txt

3. API 키 구성 — .env.example을 .env로 복사하고 키를 입력하세요:

VIRUSTOTAL_API_KEY=your_key_here
ABUSEIPDB_API_KEY=your_key_here
SHODAN_API_KEY=your_key_here

무료 API 키: VirusTotal · AbuseIPDB · Shodan

Claude Desktop

이제 서버가 HTTP를 통해 실행되므로, 먼저 서버를 시작한 다음 Claude Desktop이 URL을 통해 연결되도록 구성하세요.

1. 서버 시작 (실행 상태 유지):

python server.py

2. %APPDATA%\Claude\claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "threat-intel": {
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

API 키는 .env에서 자동으로 읽어옵니다.

중요: Claude Desktop은 시작 시에만 claude_desktop_config.json을 읽습니다. 설정을 저장한 후에는 Claude Desktop을 완전히 종료했다가 다시 시작하세요. 실행 중에는 변경 사항이 적용되지 않습니다.

MCP Inspector

서버는 8000번 포트에서 HTTP(Streamable HTTP)를 통해 실행됩니다. 먼저 서버를 시작한 다음 인스펙터를 연결하세요.

1. 서버 시작:

python server.py

2. 인스펙터 실행:

npx @modelcontextprotocol/inspector

**http://localhost:5173**을 열고, 전송 방식을 Streamable HTTP로 설정한 뒤 URL http://127.0.0.1:8000/mcp를 입력하세요.

새 도구 추가

1. 비동기 함수를 포함한 tools/newtool.py 생성

2. server.py에 등록:

from tools.newtool import my_function as _my_function

@mcp.tool()
async def my_tool(param: str) -> str:
    """Tool description shown in Inspector and to the LLM.

    Args:
        param: Parameter description
    """
    return str(await _my_function(param))

FastMCP는 서명과 독스트링으로부터 JSON 스키마를 자동으로 생성합니다.

API 속도 제한

문제 해결

JSON-RPC / EOF 오류 — 이 서버는 HTTP 전송을 사용합니다. python server.py를 직접 실행하여 시작하세요. mcp dev는 필요하지 않으며 stdio 기반 서버에만 사용됩니다.

API 키를 찾을 수 없음 — 프로젝트 루트에 .env가 있는지 확인하세요(.env.example에서 복사). 시작 시 서버는 설정되지 않은 키와 해당 키가 영향을 미치는 도구를 나열하는 경고를 출력합니다.

속도 제한 오류 — 재시도 전까지 대기하거나 유료 API 티어로 업그레이드하세요.