Security Tools Bridge

🚀 Alterx MCP 橋接工具

Alterx MCP 是連接 Alterx（強大的子域名排列生成工具）與模型上下文協議（MCP）生態系統的橋樑，能將 Alterx 子域名詞典生成能力與 MCP 兼容應用及 AI 工作流系統無縫集成，助力自動化子域發現與 AI 助手功能。

🚀 快速開始

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"
});

高級用法

基本排列

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"
});

📚 詳細文檔

參數說明

Alterx MCP 支持以下參數：

• domain：用於生成排列的目標域或子域（必需）
• pattern：用於生成詞典變化的模式模板（必需）
• outputFilePath：保存生成詞典的文件路徑（可選）

與 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. 將 Alterx 與其他子域發現工具鏈式使用於 MCP 環境中
2. 創建自定義詞典以適應不同模式，並在掃描中複用
3. 構建自動化工作流以生成排列並驗證發現的子域

致謝

• Alterx 項目：https://github.com/projectdiscovery/alterx
• 模型上下文協議：https://github.com/modelcontextprotocol