reptor-mcp: Reptor/SysReptor用MCPサーバー

このプロジェクトは、reptor CLIツールをMCP（Model-Context-Protocol）サーバーに変換し、その強力なペネトレーションテストレポート作成および自動化機能をプログラム可能なサービスとして公開します。

これにより、他のツール、スクリプト、またはAIエージェントがMCPプロトコルを介してSysReptorとプログラム的に対話できるようになり、自動化ワークフローへの統合が容易になります。

機能

• 動的ツール生成: 利用可能なすべての reptor プラグイン（nmap、nessus、burp、zap、sslyzeなど）からMCPツールを自動的に作成します。

• 直接APIツール: reptorのPython APIを直接使用して、調査結果のCRUD、スキーマ検出、テンプレート管理のための構造化されたツールを提供します。

• フィールド除外: LLMクライアントにデータを返す前に、機密フィールドをデータから削除します（環境変数で設定可能）。

• 非同期セーフ: スレッドセーフなシリアル化されたプラグイン実行を備えた、ノンブロッキングなイベントループ。

前提条件

• Python 3.10+

• uv (推奨) または pip

• APIトークンを備えた実行中の SysReptor インスタンス

インストール

git clone https://github.com/slvnlrt/reptor-mcp.git
cd reptor-mcp
uv venv && source .venv/bin/activate
uv pip install -e .

これにより、reptor と fastmcp がPyPIから自動的にインストールされます。reptorリポジトリを個別にクローンする必要はありません。

reptorのローカルチェックアウトに対して作業する必要がある場合（例：未リリースの変更をテストする場合）:

uv pip install -e /path/to/reptor-source
uv pip install -e .

または、実行時に REPTOR_MAIN_PATH=/path/to/reptor-source を設定して sys.path に注入します。

設定

サーバーは環境変数を介して設定されます:

サーバーの実行

fastmcp run mcp_server.py:mcp --transport streamable-http --port 8008

サーバーには http://localhost:8008/mcp/ からアクセス可能になります。

クライアント接続

以下のような設定を使用してMCPクライアントを接続します（例: mcp_settings.json 内）:

{
  "mcpServers": {
    "reptor-mcp": {
      "type": "streamable-http",
      "url": "http://localhost:8008/mcp/"
    }
  }
}

利用可能なツール

カスタムツール (直接API)

これらのツールは、構造化されたスキーマ対応の操作のためにreptorのPython APIを直接使用します:

プラグインツール (動的ラッパー)

サーバーは、すべての reptor CLIプラグインをMCPツールとして動的にラップします:

各ツールの正確な引数は、接続されたMCPクライアントを介して確認できます。

reptorのネイティブMCPサーバーとの関係

reptor v0.33以降、reptorには独自の組み込みMCPサーバー（reptor mcp）が含まれています。これら2つのサーバーは補完的です:

アーキテクチャ

mcp_server.py           # Server entry point, lifespan, configuration
├── tool_generator.py   # Dynamic MCP tool generation from plugin argparse definitions
│   ├── signature_utils.py  # argparse → Python function signature translation
│   └── wrapper_utils.py    # Plugin execution, stdin/stdout capture, config handling
├── custom_tools.py     # Direct API tools (findings CRUD, schema, templates)
└── tool_config.py      # Plugin exclusions, stdin consumers, config overwrite mappings

主な設計上の決定事項:

• プラグインラッパーはシリアル化ロックを備えたスレッドで実行され、共有状態を保護しながら非同期イベントループの応答性を維持します。

• カスタムツールは、ノンブロッキングなAPI呼び出しのために asyncio.to_thread() を使用します。

• フィールド除外は、クライアントに返す前に、すべてのネストされたデータ構造から指定されたフィールドを再帰的に削除します。

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細は LICENSE ファイルを参照してください。

謝辞

このプロジェクトは、SysReptorチームとその貢献者によって開発されたオリジナルの reptor CLIツール なしでは実現できませんでした。reptor-mcp は彼らの優れた成果の上に構築され、MCPインターフェースを提供します。