sjkim1127/reversecore_mcp
セキュリティファーストのMCPサーバーであり、AIエージェントによる自動リバースエンジニアリング、マルウェア解析、フォレンジック、脆弱性調査、SASTを実現します。Radare2、YARA、LIEF、Capstone などによって動作します。
Model Context Protocol による AI 搭載のリバースエンジニアリングとセキュリティ分析
Claude や Cursor などの AI アシスタントに、自然言語を通じてリバースエンジニアリング、マルウェア分析、脆弱性調査、デジタルフォレンジック、ソースコード監査を実行する能力を提供する MCP サーバー。
Reversecore MCP は、177 の分析ツールを AI アシスタントが自然言語で呼び出せる単一のインターフェースにまとめた Model Context Protocol サーバーです。
十数種類のツールそれぞれのコマンドライン構文を覚える代わりに、やりたいことを記述するだけで済みます：
"Decompile the main function of this malware sample, extract all network IOCs,
map the behavior to MITRE ATT&CK, and generate a triage report."
AIアシスタントはこれをツール呼び出しに分割します:
r2_decompile("sample.exe", "main")
→ extract_iocs("sample.exe")
→ add_mitre_technique(technique_id="T1071.001", ...)
→ create_analysis_report(template_type="quick_triage")
各ツールは構造化された ToolResult（ToolSuccess または ToolError のいずれか）を返し、AI が推論したり、後続のクエリに連鎖させたり、ユーザー向けにレンダリングしたりできる型付きデータを提供します。
| ドメイン | できること |
|---|---|
| 静的解析 | 逆アセンブル、逆コンパイル（r2ghidra）、バイナリ解析（LIEF）、パッカー検出（DIE）、ケイパビリティ検出（CAPA）、文字列抽出、ファームウェアスキャン（binwalk） |
| 動的・シンボリック実行 | ESIL エミュレーション、angr シンボリック実行、テイント解析、ファジングハーネス生成 |
| マルウェア解析 | IOC 抽出、YARA スキャン、休眠バックドア検出、適応型ワクチン生成、自律的脆弱性ハンティング |
| 脆弱性リサーチ | 危険な API の検出、ROP ガジェットの発見、ヒープエクスプロイト解析、クラッシュトリアージ、PoC 生成 |
| デジタルフォレンジック | メモリフォレンジック（Volatility3）、PCAP 解析（Scapy）、ディスクフォレンジック（Sleuth Kit）、アーティファクト相関分析 |
| ソースコード監査 | Python AST スキャン、C/C++ 正規表現パターンスキャン |
| レポーティング | MITRE ATT&CK マッピング付きのセッションベースレポート、SIGMA ルール生成、VEX レポート、メール配信 |
AI Client (Claude / Cursor / any MCP-compatible client)
│ MCP Protocol (stdio or HTTP/SSE)
▼
┌──────────────────────────────────────────────────────┐
│ FastMCP 3.4.4 Server │
│ 177 registered tools · Fully async │
│ Python 3.10–3.12 │
├────────────────────┬─────────────────────────────────┤
│ Guided Prompts │ Dynamic Resources │
│ (22 analysis │ (11 URI-based: per-binary │
│ modes) │ strings, IOCs, ASM, CFG, …) │
├────────────────────┴─────────────────────────────────┤
│ Core Infrastructure │
│ Config · Security · Validators · Exceptions (17) │
│ R2 Pool · Metrics · Memory (SQLite) · Task Queue │
│ MITRE Mapper · Evidence Engine · Resilience Layer │
│ Arch Registry (x86/ARM/MIPS/RISC-V/PPC) │
│ Result Cache (SHA256) · Analysis Cache (Redis+SQL) │
│ SAST (Python AST + C/C++ Regex) · Plugin System │
├──────────────────────────────────────────────────────┤
│ Analysis Engines │
│ Radare2 6.0.4 │ YARA 4.3.1 · LIEF · Capstone │
│ r2ghidra │ CAPA · angr · Qiling │
│ Volatility3 · Scapy│ DIE · Binwalk · Sleuth Kit │
│ pwntools · ROPgadget│ Keystone (assembler) │
└──────────────────────────────────────────────────────┘
サーバーは Python 3.10～3.12 をサポートしています。オプションの angr シンボリック実行エンジンは、安全な互換リリースが利用可能な Python 3.12 以降にインストールされます。Python 3.10 および 3.11 のインストールでは angr は省略されます。
reversecore_mcp/core/ ディレクトリには、すべてのツールが基盤とする共有インフラストラクチャが含まれています:
| モジュール | 目的 |
|---|---|
config.py | 34 以上の環境変数を持つ Pydantic BaseSettings |
security.py | 入力サニタイズ、コマンド引数の検証 |
validators.py | TOCTOU 対策を備えたファイルおよびバイナリパスの検証、シンボリックリンク解決 |
r2_pool.py | サイズ設定可能なスレッドセーフな Radare2 接続プール |
r2_helpers.py | 構造化された Radare2 出力のパース |
metrics.py | ツールごとの実行時間、呼び出し回数、エラー率、キャッシュ統計 |
memory.py | セッションをまたいで分析結果を永続化する、非同期 SQLite ベースの AI メモリストア |
mitre_mapper.py | MITRE ATT&CK テクニック ID マッピングエンジン |
evidence.py | 証拠分類システム: OBSERVED、INFERRED、POSSIBLE |
resilience.py | リトライ、サーキットブレーカー、タイムアウトのデコレータパターン |
task_queue.py | Redis + arq によるバックグラウンドタスクキュー |
extension_registry.py | プラグインの登録とライフサイクル管理 |
arch_registry.py | マルチアーキテクチャマッピング (x86、x86_64、ARM32、ARM64、MIPS、RISC-V、PPC → r2 arch/bits/registers) |
result_cache.py | SHA256 ベースのツール結果キャッシュデコレータ (@cache_tool_result) |
analysis_cache.py | 多層デコンパイルキャッシュ (L1: Redis、L2: SQLite) |
result.py | ToolSuccess / ToolError Pydantic モデル |
exceptions.py | RCMCP-E* エラーコードを持つ 17 の例外クラス |
decorators.py | @log_execution、@track_metrics |
error_handling.py | @handle_tool_errors デコレータ |
error_formatting.py | 構造化されたエラーレスポンスのフォーマット |
execution.py | タイムアウトと出力制限を備えた安全なサブプロセス実行 |
command_spec.py | サブプロセス呼び出し用のコマンド仕様 |
loader.py | 動的ツールモジュールローダー |
plugin.py | プラグイン基底クラス |
extension.py | 拡張機能基底クラス |
container.py | コンテナ/サンドボックス実行サポート |
audit.py | 監査ログ |
binary_cache.py | バイナリファイルのキャッシュ |
json_utils.py | orjson による JSON シリアライズ (標準ライブラリの json より 3～5 倍高速) |
logging_config.py | Loguru ベースの構造化ログ |
report_generator.py | レポートレンダリングエンジン (Markdown、xhtml2pdf による PDF) |
resource_manager.py | MCP リソースのライフサイクル管理 |
sast/python_ast_scanner.py | Python AST ベースの脆弱性スキャナー |
sast/regex_scanner.py | C/C++ 正規表現ベースの脆弱性スキャナー |
sast/rule_manager.py | SAST ルールの読み込みと管理 |
📖 権威あるツールカタログとパラメータリファレンス (151 ツール) 📊 ツールプロファイルのフットプリントとコンテキストベンチマークマトリクス
すべてのツールは構造化された ToolResult を返します — 型付きの data を持つ ToolSuccess、または RCMCP-E* エラーコードを持つ ToolError のいずれかです。ツールは 5 つのモジュール式実行プロファイル (full、static、malware、forensics、vuln-research) にわたる 11 のドメインプラグインに整理されています: