モデルコンテキストプロトコル(MCP)を介して強力な解析ツールを提供するHopperディスアセンバ用のFastMCPサーバープラグイン。 このプラグインを使用すると、バイナリファイルを分析したり、手順を分解したり、文書の管理したり、AIアシスタントを介してより多くのファイルを分析することができます。

##特徴

• ANSI バイナリ分析:セグメント、手順、およびデータ構造の分析
• ➡️Disassembly&Decompilation:詳細なアセンブリと擬似コード出力を入手
• 関数関係とプログラムフローの可視化
• 最近の参照解析**: メモリ参照とクロスリファレンスの追跡
• リリース** 名前、コメント、種類情報を追加
• ドキュメント管理**: 複数の実行ファイルを扱う
• 参照String Search: 高度なregex ベースの文字列検索

クイックインストール

インストールプロセスは、Python環境(conda、uv、venv、またはシステムPython)を自動的に検出し、すべての設定を行います。

です。 スクリプトは:

• ✅ Python環境を自動的に検出する
• ✅ 必要な依存関係をインストール (fastmcp)
• ✅ 正しいPythonパスでスクリプトを構成する
• ✅ 適切なホッパースクリプトディレクトリにインストールします

HopperPyMCP - FastMCP Server for Hopper Disassembler

A FastMCP server plugin for the Hopper disassembler that provides powerful analysis tools through the Model Context Protocol (MCP). This plugin allows you to analyze binary files, disassemble procedures, manage documents, and more through AI assistants.

Features

• 🔍 Binary Analysis: Analyze segments, procedures, and data structures
• 🛠️ Disassembly & Decompilation: Get detailed assembly and pseudo-code output
• 📊 Call Graph Generation: Visualize function relationships and program flow
• 🔗 Reference Analysis: Track memory references and cross-references
• 📝 Annotation Tools: Add names, comments, and type information
• 🗂️ Document Management: Handle multiple executable files
• 🔍 String Search: Advanced regex-based string searching

Quick Installation

The installation process automatically detects your Python environment (conda, uv, venv, or system Python) and configures everything for you:

# Simple one-command installation
python install.py

That’s it! The script will:

• ✅ Detect your Python environment automatically
• ✅ Install required dependencies (fastmcp)
• ✅ Configure the script with correct Python paths
• ✅ Install to the appropriate Hopper Scripts directory

Supported Environments

• Conda environments (including miniconda/anaconda)
• UV virtual environments
• Python venv/virtualenv
• System Python installations
• macOS and Linux platforms

If you use an environment like conda, uv, or virtualenv, run the install script from within a new environment, since dependencies will be installed by install.py.

Manual Installation Options

Dry Run (Preview Changes)

# See what would be installed without making changes
python install.py --dry-run

Force Installation

# Overwrite existing installation without prompting
python install.py --force

Uninstallation

Remove the plugin cleanly:

# Remove the installation
python uninstall.py

# Preview what would be removed
python uninstall.py --dry-run

# Remove without confirmation
python uninstall.py --confirm

Usage in Hopper

Once installed, the FastMCP server will be available as a script in Hopper.

Starting the Server

After running the script in Hopper, you’ll need to launch the MCP server through the Python prompt:

1. First Time Setup - Cache Strings (Recommended)

   Due to slow Hopper string APIs, the plugin creates optimized string caches for better performance. This process takes about 5-10 minutes per document and saves caches alongside your Hopper document saves.

   In the Hopper Python prompt, paste:

   cache_strings()
   

   Wait for caching to complete, then launch the server:

   launch_server()
   

2. Quick Start (Skip Caching)

   To start immediately without caching (slower string searches):

   launch_server()