{"id":27114970,"url":"https://github.com/mordavid/externalattacker-mcp","last_synced_at":"2025-04-13T08:12:19.770Z","repository":{"id":286500658,"uuid":"961579916","full_name":"MorDavid/ExternalAttacker-MCP","owner":"MorDavid","description":"A modular external attack surface mapping tool integrating tools for automated reconnaissance and bug bounty workflows.","archived":false,"fork":false,"pushed_at":"2025-04-06T20:48:36.000Z","size":939,"stargazers_count":18,"open_issues_count":0,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-12T03:58:59.258Z","etag":null,"topics":["bug-bounty","bugbounty","bugbounty-tool","dnsx","externalattacker","gobuster","httpx","mcp","mcp-server","nuclei","nuclei-templates","projectdiscovery","tlsx"],"latest_commit_sha":null,"homepage":"https://www.MORDAVID.com","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MorDavid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"mordavid","patreon":"mordavid","open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":"mordavid","thanks_dev":null,"custom":null}},"created_at":"2025-04-06T19:56:11.000Z","updated_at":"2025-04-11T20:00:52.000Z","dependencies_parsed_at":"2025-04-06T21:39:24.657Z","dependency_job_id":null,"html_url":"https://github.com/MorDavid/ExternalAttacker-MCP","commit_stats":null,"previous_names":["mordavid/externalattacker-mcp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MorDavid%2FExternalAttacker-MCP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MorDavid%2FExternalAttacker-MCP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MorDavid%2FExternalAttacker-MCP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MorDavid%2FExternalAttacker-MCP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MorDavid","download_url":"https://codeload.github.com/MorDavid/ExternalAttacker-MCP/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248514202,"owners_count":21116900,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bug-bounty","bugbounty","bugbounty-tool","dnsx","externalattacker","gobuster","httpx","mcp","mcp-server","nuclei","nuclei-templates","projectdiscovery","tlsx"],"created_at":"2025-04-07T04:39:33.353Z","updated_at":"2025-04-12T03:59:02.867Z","avatar_url":"https://github.com/MorDavid.png","language":"Python","funding_links":["https://github.com/sponsors/mordavid","https://patreon.com/mordavid","https://buymeacoffee.com/mordavid"],"categories":[],"sub_categories":[],"readme":"# ExternalAttacker MCP Server\n\n![ExternalAttacker-MCP](/images/ExternalAttacker-MCP-Banner.png)\n\n## Model Context Protocol (MCP) Server for External Attack Surface Management\n\nExternalAttacker is a powerful integration that brings automated scanning capabilities with natural language interface for comprehensive external attack surface management and reconnaissance.\n\n\u003e 🔍 **Automated Attack Surface Management with AI!**  \n\u003e Scan domains, analyze infrastructure, and discover vulnerabilities using natural language.\n\n## 🔍 What is ExternalAttacker?\n\nExternalAttacker combines the power of:\n\n* **Automated Scanning**: Comprehensive toolset for external reconnaissance\n* **Model Context Protocol (MCP)**: An open protocol for creating custom AI tools\n* **Natural Language Processing**: Convert plain English queries into scanning commands\n\n## 📱 Community\n\nJoin our Telegram channel for updates, tips, and discussion:\n- **Telegram**: [https://t.me/root_sec](https://t.me/root_sec)\n\n## ✨ Features\n\n* **Natural Language Interface**: Run scans using plain English\n* **Comprehensive Scanning Categories**:\n  * 🌐 Subdomain Discovery (subfinder)\n  * 🔢 Port Scanning (naabu)\n  * 🌍 HTTP Analysis (httpx)\n  * 🛡️ CDN Detection (cdncheck)\n  * 🔐 TLS Analysis (tlsx)\n  * 📁 Directory Fuzzing (ffuf, gobuster)\n  * 📝 DNS Enumeration (dnsx)\n\n## 📋 Prerequisites\n\n* Python 3.8 or higher\n* Go (for installing tools)\n* MCP Client\n\n## 🔧 Installation\n\n1. Clone this repository:\n    ```bash\n    git clone https://github.com/mordavid/ExternalAttacker-MCP.git\n    cd ExternalAttacker\n    ```\n\n2. Install Python dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. Install required Go tools:\n   ```bash\n   go install -v github.com/projectdiscovery/subfinder/v2/cmd/subfinder@latest\n   go install -v github.com/projectdiscovery/naabu/v2/cmd/naabu@latest\n   go install -v github.com/projectdiscovery/httpx/cmd/httpx@latest\n   go install -v github.com/projectdiscovery/cdncheck/cmd/cdncheck@latest\n   go install -v github.com/projectdiscovery/tlsx/cmd/tlsx@latest\n   go install -v github.com/ffuf/ffuf@latest\n   go install github.com/OJ/gobuster/v3@latest\n   go install -v github.com/projectdiscovery/dnsx/cmd/dnsx@latest\n   ```\n\n4. Run ExternalAttacker-App.py\n    ```bash\n    python ExternalAttacker-App.py\n    # Access http://localhost:6991\n    ```\n\n5. Configure the MCP Server\n    ```bash\n    \"mcpServers\": {\n        \"ExternalAttacker-MCP\": {\n            \"command\": \"python\",\n            \"args\": [\n                \"\u003cYour_Path\u003e\\\\ExternalAttacker-MCP.py\"\n            ]\n        }\n    }\n    ```\n\n## 🚀 Usage\n\nExample queries you can ask through the MCP:\n\n* \"Scan example.com for subdomains\"\n* \"Check open ports on 192.168.1.1\"\n* \"Analyze HTTP services on test.com\"\n* \"Check if domain.com uses a CDN\"\n* \"Analyze SSL configuration of site.com\"\n* \"Fuzz endpoints on target.com\"\n\n## 📜 License\n\nMIT License\n\n## 🙏 Acknowledgments\n\n* The ProjectDiscovery team for their excellent security tools\n* The MCP community for advancing AI-powered tooling\n\n---\n\n_Note: This is a security tool. Please use responsibly and only on systems you have permission to test._","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmordavid%2Fexternalattacker-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmordavid%2Fexternalattacker-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmordavid%2Fexternalattacker-mcp/lists"}