Cyberbro MCP Server

Cyberbro를 위한 Model Context Protocol 서버입니다.

이 프로젝트는 표준 Python 배포판으로 패키징되어 있으며 다음 명령어로 실행할 수 있습니다:

• uvx mcp-cyberbro

• pip install mcp-cyberbro 후 mcp-cyberbro

이 서버를 사용하는 이유

• Cyberbro 엔진을 통해 관찰 대상(IP, 도메인, URL, 해시 등)을 분석합니다.

• MCP 지원 어시스턴트에서 위협 분석 작업을 직접 통합합니다.

• stdio, sse 또는 streamable-http 전송 방식으로 실행합니다.

• 이러한 전송 방식 중 하나를 지원하는 모든 MCP 클라이언트와 호환됩니다.

설치

uvx 사용 (독립형)

uvx mcp-cyberbro --cyberbro_url http://localhost:5000

pip 사용

pip install mcp-cyberbro
mcp-cyberbro --cyberbro_url http://localhost:5000

로컬 개발

pip install -e .
mcp-cyberbro --cyberbro_url http://localhost:5000

Docker

기본 컨테이너 명령은 streamable-http 모드(포트 8000)로 시작합니다.

docker run --rm -p 8000:8000 \
  -e CYBERBRO_URL=http://host.docker.internal:5000 \
  ghcr.io/stanfrbd/mcp-cyberbro:latest

stdio 전송 방식을 강제하려면:

docker run -i --rm \
  -e CYBERBRO_URL=http://host.docker.internal:5000 \
  ghcr.io/stanfrbd/mcp-cyberbro:latest \
  --transport stdio

구성

.env.example을 복사하고 최소한 다음을 설정하세요:

• CYBERBRO_URL (필수)

지원되는 환경 변수:

• CYBERBRO_URL

• API_PREFIX (기본값: api)

• SSL_VERIFY (true/false)

• MCP_TRANSPORT (stdio, sse, streamable-http)

• MCP_HOST

• MCP_PORT

• MCP_MOUNT_PATH

• MCP_SSE_PATH

• MCP_STREAMABLE_HTTP_PATH

CLI 플래그도 사용할 수 있으며 환경 변수 값을 덮어씁니다.

MCP 클라이언트 통합

이 서버를 Claude Desktop, Claude Code, Cursor, OpenAI 호환 MCP 클라이언트 또는 기타 MCP 클라이언트와 함께 사용할 수 있습니다.

uvx를 사용한 구성 예시:

{
  "mcpServers": {
    "cyberbro": {
      "command": "uvx",
      "args": ["mcp-cyberbro"],
      "env": {
        "CYBERBRO_URL": "http://localhost:5000"
      }
    }
  }
}

Docker + stdio 사용 예시:

{
  "mcpServers": {
    "cyberbro": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CYBERBRO_URL",
        "ghcr.io/stanfrbd/mcp-cyberbro:latest",
        "--transport",
        "stdio"
      ],
      "env": {
        "CYBERBRO_URL": "http://localhost:5000"
      }
    }
  }
}

VSCode에서의 사용 - 예시

.vscode/mcp.json 생성

{
	"servers": {
		"mcp-cyberbro": {
			"type": "stdio",
			"command": "uvx",
			"args": [
				"mcp-cyberbro"
			],
			"env": {
				"CYBERBRO_URL": "http://127.0.0.1:5000"
			}
		}
	}
}

MCP 레지스트리 메타데이터

server.json은 MCP 레지스트리 게시를 위해 포함되어 있으며 PyPI 패키지 mcp-cyberbro를 가리킵니다.

릴리스 파이프라인

릴리스 생성 워크플로우:

• .github/workflows/publish-test-pypi.yml

• .github/workflows/publish-pypi.yml

• .github/workflows/publish-mcp-plugin.yml

사용 가능한 도구

• analyze_observable

• is_analysis_complete

• get_analysis_results

• get_engines

• get_web_url

프롬프트 예시

Cyberbro에 연결된 MCP 지원 어시스턴트와 함께 사용할 수 있는 실용적인 프롬프트 예시입니다.

지표 세부 정보 가져오기

• Cyberbro: target.com에 대한 지표를 확인하세요.

• Cyberbro로 이 IP 평판을 확인할 수 있나요? 192.168.1.1. github, google 및 virustotal 엔진을 사용하세요.

• 도메인 example.com을 분석하고 싶습니다. Cyberbro가 이에 대해 무엇을 알려줄 수 있나요? 최대 3개의 엔진을 사용하세요.

• Cyberbro로 다음 관찰 대상을 분석하세요: suspicious-domain.com, 8.8.8.8, 44d88612fea8a8f36de82e1278abb02f. 사용 가능한 모든 엔진을 사용하세요.

관찰 대상 분석

• (hash|domain|url|ip|extension)을 찾았습니다. Cyberbro에 분석을 제출하고 결과를 분석해 줄 수 있나요?

OSINT 조사

• Cyberbro를 사용하여 도메인 example.com에 대한 OSINT 보고서를 작성하세요. 사용 가능한 모든 엔진을 사용하고 결과에서 피벗하여 더 많은 정보를 얻으세요. 최대 10개의 분석 요청을 사용하세요.

감사의 말

• Model Context Protocol

• MCP Python SDK

• Cyberbro

라이선스

MIT