Security Tools Bridge

🚀 Alterx MCP 橋接ツール

Alterx MCPは、強力なサブドメイン排列生成ツールであるAlterxと、モデルコンテキストプロトコル（MCP）エコシステムをつなぐ橋渡しの役割を果たします。

🚀 クイックスタート

Alterx MCPは、Alterxのサブドメイン辞書生成機能をMCP互換のアプリケーションやAIワークフローシステムにシームレスに統合します。この橋接により、Alterxのパターンベースの排列システムを利用し、標準化されたプロトコルを通じて自動化されたサブドメイン発見パイプラインやAIアシスタント機能に組み込むことができます。

✨ 主な機能

• サブドメイン発見のためのパターンベースの辞書生成
• 複数の排列パターンと戦略をサポート
• 簡単な設定と構成
• 他のMCP互換ツールやシステムとの容易な統合

📦 インストール

前提条件

• Node.js（v16以上）
• システムにAlterxがインストールされていること
• MCP SDK

設定手順

1. このリポジトリをクローンします：

   git clone https://github.com/cyproxio/mcp-for-security
   cd alterx-mcp
   

2. 依存関係をインストールします：

   npm install
   

3. プロジェクトをビルドします：

   npm run build
   

💻 使用例

基本的な使用法

基本設定

MCPクライアント設定でAlterx MCPサーバーを設定します：

{
  "alterx": {
    "command": "node",
    "args": [
      "/path/to/alterx-mcp/build/index.js",
      "alterx"
    ]
  }
}

Alterxの実行

設定が完了したら、MCPインターフェースを通じて do-alterx ツールを使用してAlterxを実行できます：

// MCPを使用してAlterxを呼び出す例
const result = await mcp.tools.invoke("do-alterx", {
  domain: "api.example.com",
  pattern: "{{word}}-{{sub}}.{{suffix}}",
  outputFilePath: "wordlist.txt"
});

高度な使用法

パラメータ説明

Alterx MCPは以下のパラメータをサポートしています：

• domain：排列を生成する対象のドメインまたはサブドメイン（必須）
• pattern：辞書の変化を生成するためのパターンテンプレート（必須）
• outputFilePath：生成された辞書を保存するファイルパス（オプション）

基本排列

const result = await mcp.tools.invoke("do-alterx", {
  domain: "api.example.com",
  pattern: "{{sub}}-{{word}}.{{suffix}}"
});

複数のパターン

const result = await mcp.tools.invoke("do-alterx", {
  domain: "api.example.com",
  pattern: "{{sub}}-{{word}}.{{suffix}},{{word}}.{{sub}}.{{suffix}}",
  outputFilePath: "combined_wordlist.txt"
});

📚 ドキュメント

AIアシスタントとの統合

Alterx MCPは、モデルコンテキストプロトコルをサポートするAIアシスタントとシームレスに連携するように設計されており、サブドメインの発見と列挙タスクの自然言語対話を可能にします。

サンプル会話

ユーザー：api.example.comのサブドメイン排列を生成してください
AI：Alterxを使用してサブドメイン排列を生成します。

[AIがAlterx MCPを使用して排列を実行し、結果を返す]

以下のサブドメイン排列を生成しました：
- dev-api.example.com
- stage-api.example.com
- test-api.example.com
- api-dev.example.com
- api-stage.example.com
...

セキュリティ上の注意事項

• 適切な許可を得た後にのみ、ドメインのサブドメインスキャンを行ってください。
• 使用時には責任と倫理に配慮してください。
• このツールは合法的なセキュリティ研究とテストにのみ使用することを目的としています。

トラブルシューティング

問題が発生した場合：

1. Alterxが正しくインストールされ、アクセス可能であることを確認してください。
2. 設定でAlterxの実行ファイルのパスが正しいことを確認してください。
3. 適切な実行権限が設定されていることを確認してください。
4. サーバーログを確認して詳細なエラー情報を取得してください。

高度な使用法

より複雑なシナリオでは、以下のことができます：

1. MCP環境でAlterxを他のサブドメイン発見ツールと連鎖させて使用する。
2. 異なるパターンに適応するカスタム辞書を作成し、スキャンで再利用する。
3. 排列を生成し、発見されたサブドメインを検証する自動化ワークフローを構築する。

🔗 謝辞

• Alterxプロジェクト：https://github.com/projectdiscovery/alterx
• モデルコンテキストプロトコル：https://github.com/modelcontextprotocol