Двоичный ниндзя MCP

Этот репозиторий содержит плагин Binary Ninja, сервер MCP и мост, который обеспечивает бесшовную интеграцию возможностей Binary Ninja с вашим любимым клиентом LLM.

Функции

• Простая интеграция в реальном времени между клиентами Binary Ninja и MCP

• Улучшенный процесс обратного проектирования с помощью ИИ

• Основная поддержка Claude Desktop как клиента MCP, но расширяемая для других интеграций

Related MCP server: GhidraMCP

Примеры

Создание отчета по двоичному анализу

Переименование функций

Компоненты

Этот репозиторий содержит два отдельных компонента:

1. Плагин Binary Ninja, который предоставляет сервер MCP, раскрывающий возможности Binary Ninja через конечные точки HTTP. Его можно использовать с любым клиентом, реализующим протокол MCP.

2. Отдельный компонент моста MCP, который соединяет ваш любимый клиент MCP с сервером Binary Ninja MCP. Хотя Claude Desktop является основным путем интеграции, сервер MCP может использоваться с другими клиентами.

Поддерживаемые интеграции

В следующей таблице указано, какие интеграции с Binary Ninja поддерживаются в настоящее время.

Предпосылки

• Двоичный ниндзя

• Питон 3.12+

• Claude Desktop (или предпочтительная интеграция)

Установка

Плагин Binary Ninja

Вы можете установить плагин через менеджер плагинов Binary Ninja ( Plugins > Manage Plugins ).

Чтобы вручную настроить плагин, этот репозиторий можно скопировать в папку плагинов Binary Ninja.

Claude Desktop Bridge (опционально)

Это необходимо только в том случае, если вы хотите использовать Claude Desktop в качестве клиента MCP. Сначала убедитесь, что у вас настроена виртуальная среда:

git clone git@github.com:fosdickio/binary_ninja_mcp.git
cd binary_ninja_mcp

python3 -m venv .venv
source .venv/bin/activate   # On macOS/Linux

pip install -r bridge/requirements.txt

Автоматическая конфигурация (Mac)

На Mac вы можете автоматизировать настройку, выполнив:

./scripts/setup_claude_desktop.py

Ручная настройка

В других операционных системах или для ручной настройки интеграции Claude Desktop:

1. Перейдите в Settings > Developer > Edit Config

2. Добавьте следующую конфигурацию:

{
  "mcpServers": {
    "binary_ninja_mcp": {
      "command": "/ABSOLUTE/PATH/TO/binary_ninja_mcp/.venv/bin/python",
      "args": [
        "/ABSOLUTE/PATH/TO/binary_ninja_mcp/bridge/binja_mcp_bridge.py"
      ]
    }
  }
}

Примечание: замените /ABSOLUTE/PATH/TO на фактический абсолютный путь к каталогу вашего проекта. Для доступа к установленным зависимостям необходимо использовать интерпретатор Python виртуальной среды.

Использование

Клод Десктоп

1. Откройте Binary Ninja и установите плагин Binary Ninja MCP

2. Перезапустите Binary Ninja, а затем откройте двоичный файл.

3. Запустите сервер MCP ( Plugins > MCP Server > Start MCP Server )

4. Запустить Claude Desktop

Интеграция будет автоматически доступна после открытия Claude Desktop.

Теперь вы можете начать подсказывать Клоду о текущем открытом бинарнике. Примеры подсказок:

• «Создать отчет по бинарному анализу для текущего двоичного файла».

• «Переименовать функцию X в Y в текущем двоичном файле».

• «Перечислить все функции в текущем двоичном файле».

• «Каков статус загруженного двоичного файла?»

Другие интеграции MCP-клиента

Мост можно использовать с другими клиентами MCP, реализовав соответствующий уровень интеграции.

Разработка

Структура проекта организована следующим образом:

binary_ninja_mcp/
├── bridge/                      # MCP client integration
├── plugin/                      # Binary Ninja plugin
├── scripts/
│   └── setup_claude_desktop.py  # Setup script for Claude Desktop

Внося вклад

Вклады приветствуются. Пожалуйста, не стесняйтесь отправлять запрос на включение.