Cyberbro MCP Server

Сервер протокола контекста модели (MCP) для Cyberbro.

Этот проект упакован как стандартный дистрибутив Python и может быть запущен с помощью:

• uvx mcp-cyberbro

• pip install mcp-cyberbro, затем mcp-cyberbro

Зачем нужен этот сервер

• Анализ наблюдаемых объектов (IP, домен, URL, хеш и т. д.) через движки Cyberbro.

• Интеграция действий по анализу угроз непосредственно в помощники с поддержкой 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, MCP-клиентами, совместимыми с OpenAI, или любым другим 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

Примеры промптов

Вот практические примеры промптов, которые можно использовать с любым помощником с поддержкой MCP, подключенным к Cyberbro.

Получение подробной информации об индикаторах

• Cyberbro: Проверь индикаторы для target.com

• Можешь проверить репутацию этого IP с помощью Cyberbro? 192.168.1.1. Используй движки github, google и virustotal.

• Я хочу проанализировать домен example.com. Что Cyberbro может рассказать о нем? Используй максимум 3 движка.

• Проанализируй эти объекты с помощью Cyberbro: suspicious-domain.com, 8.8.8.8 и 44d88612fea8a8f36de82e1278abb02f. Используй все доступные движки.

Анализ объектов

• Я нашел это (хеш|домен|url|ip|расширение). Можешь отправить это на анализ в Cyberbro и проанализировать результаты?

OSINT-расследование

• Создай отчет OSINT для домена example.com, используя Cyberbro. Используй все доступные движки и переходи к результатам для получения дополнительной информации. Используй максимум 10 запросов на анализ.

Благодарности

• Model Context Protocol

• MCP Python SDK

• Cyberbro

Лицензия

MIT