Spectre-mcp

<div align="center"> ``` ███████╗██████╗ ███████╗ ██████╗████████╗██████╗ ███████╗ ██╔════╝██╔══██╗██╔════╝██╔════╝╚══██╔══╝██╔══██╗██╔════╝ ███████╗██████╔╝█████╗ ██║ ██║ ██████╔╝█████╗ ╚════██║██╔═══╝ ██╔══╝ ██║ ██║ ██╔══██╗██╔══╝ ███████║██║ ███████╗╚██████╗ ██║ ██║ ██║███████╗ ╚══════╝╚═╝ ╚══════╝ ╚═════╝ ╚═╝ ╚═╝ ╚═╝╚══════╝ ``` **监控 · 渗透 · 利用 · 网络威胁情报引擎** *终极的OSINT + 渗透测试MCP服务器，用于AI代理。* [](https://github.com/ItisPhoenix/Spectre-mcp/stargazers) [](https://github.com/ItisPhoenix/Spectre-mcp/network/members) [](https://github.com/ItisPhoenix/Spectre-mcp/issues) [](https://github.com/ItisPhoenix/Spectre-mcp) [](https://www.kali.org/) [](https://modelcontextprotocol.io/) [](https://python.org) [](https://hub.docker.com/) </div> --- ## 什么是SPECTRE？ **SPECTRE** 将您的AI代理转变为全方位的安全研究人员。它运行一个容器化的 **Kali Linux** 环境，并将内部的所有工具暴露给任何兼容MCP的AI，通过 **MCP Streamable-HTTP**。只需一个命令即可启动。只需一个URL即可连接您的代理。 服务器暴露了 **139+工业级安全工具** —— 从被动OSINT到主动利用 —— 所有工具都封装为干净的、类型化的MCP工具，任何有能力的AI都可以原生调用，包括Claude Code、Gemini CLI、Cursor和Windsurf。 > ⚠️ **仅用于授权的渗透测试和研究。** 使用此软件时，您同意遵守所有适用的本地和国际法律。 --- ## 主要功能 | 模块 | 您的AI可以执行的操作 | | :--- | :--- | | 🔍 **OSINT** | 在3000+个网站上搜索用户名，调查电子邮件、电话号码、社交资料 | | 🌐 **域名和IP情报** | WHOIS，DNS，子域名枚举，证书透明度，Shodan，威胁情报 | | 🕸️ **网络情报** | 爬取，指纹扫描，扫描CVE，模糊目录，绕过WAF，检查TLS | | 🧠 **网络爬取** | 隐秘获取JS-heavy页面，提取CSS/XPath，爬取整个域名 | | 💥 **利用** | Metasploit，searchsploit，CVE查找，利用建议，逆shell生成 | | 🔑 **密码攻击** | Hydra，John，Hashcat，自定义词典生成，哈希识别 | | 🔗 **网络攻击** | ARP中毒，NTLM哈希捕获，数据包捕获，SMB枚举 | | 🏴‍☠️ **利用后** | LinPEAS，完整的Linux枚举，Mimikatz集成 | | 🪙 **区块链** | BTC/ETH地址情报，交易查找 | | 👤 **上帝模式** | 单次调用完整的域名配置文件，完整的人员档案，完整的渗透测试重构链 | --- ## 快速开始 ```bash # 1. 克隆仓库 git clone https://github.com/ItisPhoenix/Spectre-mcp.git cd Spectre-mcp # 2. 启动引擎（首次构建需要10-20分钟） docker compose up -d --build # 3. 连接您的AI # Claude Code claude mcp add spectre http://localhost:8001/mcp # Gemini CLI gemini mcp add --transport Streamable-HTTP, --trust spectre http://localhost:8001/mcp # Cursor / Windsurf / Cline → add Streamable-HTTP, server at http://localhost:8001/mcp ``` 通过询问您的AI验证所有内容是否正常运行： > *"运行`spectre_status`并向我显示已安装的工具。"* --- ## 架构 ``` ┌──────────────────────────────────────────────────────┐ │ AI代理/CLI │ │ (Claude Code, Gemini CLI, Cursor ...) │ └───────────────────────┬──────────────────────────────┘ │ MCP / Streamable-HTTP (端口8001) ┌───────────────────────▼──────────────────────────────┐ │ spectre.py (FastMCP服务器) │ │ mcp==1.24.0 · fastmcp==2.3.3 │ └──────┬──────────┬──────────┬──────────────┬──────────┘ │ │ │ │ OSINT 网络 网络应用 渗透测试 模块 模块 模块 模块 (sherlock, (nmap,mass- (nuclei, (msf,hydra, maigret, scan,httpx) nikto, john,CME, holehe ...) gobuster) responder) │ Kali Linux容器 ─ apt软件包 + Go工具 + Python虚拟环境 ``` 服务器完全运行在基于`kalilinux/kali-rolling`的Docker容器中。MCP层是一个单独的Python文件（`spectre.py`），使用**FastMCP**进行Streamable-HTTP，这意味着任何支持MCP的AI都可以通过HTTP与零自定义集成连接。 --- ## 工具生态系统 ### 👤 身份和人员OSINT | 工具 | MCP函数 | 功能 | | :--- | :--- | :--- | | Sherlock | `sherlock_username` | 在400+个社交网络上搜索用户名 | | Maigret | `maigret_username` | 跨3000+个网站的深度用户名重构 | | Holehe | `holehe_email` | 检查一个电子邮件是否在120+个网站注册 | | H8mail | `h8mail_breach` | 在数据泄露数据库中搜索电子邮件/用户名 | | SocialScan | `socialscan_check` | 检查用户名/电子邮件可用性 | | PhoneInfoga | `phoneinfoga_scan` | 电话号码情报（运营商，国家，类型） | | OSRFramework | `osrf_usufy` `osrf_mailfy` `osrf_searchfy` | 多平台用户名，电子邮件和实体搜索 | ### 📧 电子邮件情报 | 工具 | MCP函数 | 功能 | | :--- | :--- | :--- | | theHarvester | `email_harvest` | 从搜索引擎中获取域名的所有电子邮件 | | SMTP Probe | `email_verify` | 通过SMTP验证电子邮件地址是否可达 | | GHunt | `ghunt_google` | 深度谷歌账户调查（地图，照片，日历） | | HIBP | `hibp_check` | 检查HaveIBeenPwned以获取泄露记录 | ### 📱 社交媒体情报（SOCMINT） | 工具 | MCP函数 | 功能 | | :--- | :--- | :--- | | Google Dork | `linkedin_search` `linkedin_company` | 查找LinkedIn个人资料和公司 | | Reddit API | `reddit_user` `reddit_search` | 调查用户和搜索社区 | | GitHub API | `github_user` `github_email_leak` `github_dork` `github_secrets` | 完整的GitHub重构和秘密提取 | | Telegram | `telegram_search` | 搜索公共Telegram频道和群组 | ### 🌐 域名和IP情报 | 工具 | MCP函数 | 功能 | | :--- | :--- | :--- | | whois | `whois_lookup` | 域名/IP注册和所有者信息 | | dig | `dns_lookup` `reverse_dns` | DNS记录（A，MX，TXT，ANY ...） | | ipinfo / ip-api | `ip_info` `ip_geolocate` | ASN，组织，国家，城市，ISP | | ipinfo | `asn_lookup` | 组织拥有的所有IP范围 | | crt.sh | `cert_transparency` | 域名颁发的SSL证书 | | Subfinder | `subfinder_enum` | 通过50+个来源的被动子域名枚举 | | Amass | `amass_enum` | 综合的OWASP子域名枚举 | | dnsx | `dnsx_resolve` | 快速DNS解析和子域名强迫 | | Shodan | `shodan_host` `shodan_search` | 开放端口，服务，CVE（回落到InternetDB） | | Censys | `censys_query` | 暴露的服务和证书搜索 | | Wayback Machine | `wayback_urls` | 域名的所有存档URL | | GAU | `gau_urls` | 来自Wayback，OTX，Common Crawl，URLScan的所有URL | | URLScan.io | `urlscan_lookup` | 过去的扫描，截图和技术栈 | | VirusTotal | `virustotal_domain` `virustotal_ip` | 恶意软件检测和声誉 | | ThreatFox | `threatfox_lookup` | 检查IPs/域名/哈希值是否符合恶意软件IOCs | | AbuseIPDB | `abuseipdb_check` | IP滥用报告和声誉分数 | | HackerTarget | `reverse_ip` `dns_history` | 反向IP查找和过去的DNS记录 | ### 🔌 网络和端口情报 | 工具 | MCP函数 | 功能 | | :--- | :--- | :--- | | Nmap | `nmap_scan` `nmap_vuln` `nmap_full` `nmap_udp_scan` | 端口扫描，漏洞脚本，完整65535端口扫描，UDP | | Masscan | `masscan_scan` | 世界上最快的端口扫描器 | | Naabu | `naabu_scan` | 快速端口扫描和服务发现 | | Httpx | `httpx_probe` | HTTP/S探测 - 状态，标题，技术栈 | | TLSx | `tlsx_scan` | TLS指纹识别，密码套件，JA3 | | Traceroute | `traceroute_host` | 网络路径跟踪 | | Nmap | `ping_sweep` `arp_scan` | 在CIDR范围和本地网络上主机发现 | ### 🕸️ 网络应用情报 | 工具 | MCP函数 | 功能 | | :--- | :--- | :--- | | WhatWeb | `whatweb_scan` | CMS，框架，服务器和Analytics指纹识别 | | WafW00f | `wafw00f_scan` | WAF检测和识别 | | Nikto | `nikto_scan` | Web服务器漏洞和配置扫描 | | Nuclei | `nuclei_scan` `nuclei_cve_scan` | 6000+模板；CVE特定扫描 | | Gobuster | `gobuster_dir` | 目录和文件强迫 | | FFUF | `ffuf_fuzz` | Web模糊器，用于目录，参数和虚拟主机 | | Katana | `katana_crawl` | 下一代Web爬取器，支持JavaScript解析 | | SSLScan | `sslscan_check` | SSL/TLS密码协议证书 | | testssl.sh | `testssl_run` | 检查BEAST，POODLE，Heartbleed等 | | curl | `headers_security` | HTTP安全头分析（CSP，HSTS，X-Frame ...） | | curl | `js_secrets` | 从JavaScript文件中提取硬编码的API密钥 | ### 🧠 网络爬取（Scrapling） | MCP函数 | 功能 | | :--- | :--- | | `scrapling_fetch` | 获取页面；模式：`fetcher`（快速），`dynamic`（JS），`stealth`（反机器人绕过） | | `scrapling_extract` | 通过CSS或XPath选择器提取元素 | | `scrapling_extract_patterns` | 提取匹配正则表达式的数据 | | `scrapling_crawl` | 跟随同一域名的链接，达到指定深度 | | `scrapling_smart_content` | 自动提取主文章/文本内容，无需选择器 | | `scrapling_session_fetch` | 使用持久会话和自定义cookie获取 | | `scrapling_screenshot` | 使用StealthyFetcher截图网页 | | `scrapling_bypass_check` | 测试Scrapling是否可以绕过网站的反机器人措施 | ### 🔎 搜索和查找 | MCP函数 | 功能 | | :--- | :--- | | `google_dork` | 针对任何目标的自定义谷歌搜索 | | `shodan_dork` | 使用Shodan语法的高级搜索 | | `github_dork` | 在GitHub上搜索暴露的凭证和API密钥 | | `dork_exposed_files` | 查找暴露的敏感文件（SQL，env，备份，管理面板） | ### 🪙 加密货币和区块链 | MCP函数 | 功能 | | :--- | :--- | | `btc_address` | 比特币余额，交易，总收到/发送 | | `eth_address` | 以太坊余额，代币持有，最近交易 | | `crypto_tx` | 查找BTC或ETH交易哈希 | ### 🏢 公司和商业情报 | MCP函数 | 功能 | | :--- | :--- | | `company_search` | OpenCorporates - 注册，执行官，管辖区 | | `linkedin_company` | LinkedIn公司页面和员工发现 | | `sec_filing` | SEC EDGAR - 10-K，10-Q， 8-K文件 | | `mx_finder` | 域名邮件服务器和邮件格式 | ### 💥 利用和漏洞情报 | MCP函数 | 功能 | | :--- | :--- | | `searchsploit_search` | 通过软件名称或版本搜索Exploit-DB | | `searchsploit_get` | 通过数字ID查看利用源码 | | `cve_lookup` | CVSS评分，描述，受影响软件，PoC链接 | | `exploit_suggest` | Explot-DB和NVD组合的利用建议 | ### 🕵️ OSINT框架 | MCP函数 | 功能 | | :--- | :--- | | `spiderfoot_scan` | 蜘蛛足自动OSINT跨200+个数据源 | | `recon_ng_query` | Recon-ng框架，任意模块 | ### 🖥️ 网络服务枚举 | MCP函数 | 功能 | | :--- | :--- | | `enum4linux_scan` | Windows/Samba - 用户，共享，组，密码策略 | | `smb_enum` | SMB共享，用户，操作系统版本 | | `snmp_enum` | SNMP设备信息，接口，运行进程 | | `ldap_enum` | LDAP用户，组，域名信息 | | `ftp_enum` | FTP匿名访问，横幅，版本 | | `ssh_enum` | SSH算法，主机密钥，身份验证方法 | ### 🔑 密码攻击 | MCP函数 | 功能 | | :--- | :--- | | `hydra_attack` | 强力登录攻击（SSH，HTTP，FTP，SMB ...） | | `john_crack` | 使用John the Ripper破解密码哈希 | | `hashcat_crack` | GPU加速哈希破解（MD5，NTLM，sha512crypt ...） | | `hash_identify` | 确定未知哈希类型 | | `crunch_wordlist` | 使用任意字符集和长度生成自定义词典 | ### 💣 利用 | MCP函数 | 功能 | | :--- | :--- | | `msfconsole_run` | 非交互式运行Metasploit命令 | | `msfvenom_generate` | 生成shellcode和有效载荷 | ### 🔗 网络攻击 | MCP函数 | 功能 | | :--- | :--- | | `arpspoof_run` | ARP中毒在目标和网关之间 | | `responder_run` | 通过LLMNR/NBT-NS中毒捕获NTLM哈希 | | `crackmapexec_run` | SMB/WinRM/SSH/LDAP枚举和凭证测试 | | `impacket_run` | 任意Impacket脚本（secretsdump， psexec，GetUserSPNs ...） | | `tcpdump_capture` | 任意接口的数据包捕获 | | `netcat_run` | 端口扫描，横幅抓取，反向shell | | `smbclient_run` | 列出或访问SMB共享 | ### 🏴‍☠️ 利用后 | MCP函数 | 功能 | | :--- | :--- | | `linpeas_run` | 运行LinPEAS Linux权限提升检查器 | | `linux_enum` | 完整的Linux枚举 - id，用户，SUID，cron，env，历史记录 | | `mimikatz_run` | Mimikatz凭证转储（或Metasploit kiwi备用） | ### 📡 无线 | MCP函数 | 功能 | | :--- | :--- | | `aircrack_run` | 从数据包捕获文件中破解WEP/WPA | | `airodump_run` | 捕获无线数据包并列出附近的AP | ### 🛠️ 实用工具 | MCP函数 | 功能 | | :--- | :--- | | `download_file` | 将任何URL下载到容器文件系统 | | `generate_reverse_shell` | 为bash，python，php，perl，nc，powershell生成单行命令 | | `encode_payload` | 将有效载荷编码为base64，URL或十六进制 | | `run_command` | 在容器中执行任意shell命令 | | `spectre_status` | 显示服务器配置，API密钥状态和所有已安装的二进制文件 | --- ## ⚡ 上帝模式 - 完整目标配置文件 三种高级别工具，自动链接多个工具以获取单个命令。 ### `full_domain_profile(domain)` 运行**10个工具顺序** - WHOIS → DNS → 子域名枚举 → 证书透明度 → IP地理位置 → 开放端口 → 网络技术 → 电子邮件收集 → 存档URL → 威胁情报。 ### `full_person_profile(name, email, username, phone)` 提供任意组合的标识符。运行Sherlock，Holehe，H8mail，PhoneInfoga和社交媒体搜索等工具。 ### `full_pentest_recon(target)` 完整的渗透测试重构链 - **Nmap → Httpx → WhatWeb → Nikto → Nuclei → Gobuster → SSLScan** - 一次调用。 --- ## 配置 `docker-compose.yml`中的所有设置都可以通过环境变量调整。 | 变量 | 默认值 | 描述 | | :--- | :--- | :--- | | `MCP_HOST` | `0.0.0.0` | 绑定地址 | | `MCP_PORT` | `8001` | 监听端口 | | `MCP_TRANSPORT` | `Streamable-HTTP,` | | `TOOL_TIMEOUT` | `600` | 默认超时（秒）每工具调用 | | `SPECTRE_PYTHON` | `/opt/mcp-venv/bin/python3` | 容器内的Python解释器 | | `SPECTRE_WORDLIST` | `/usr/share/wordlists/dirb/common.txt` | 模糊工具的默认词典 | | `SHODAN_API_KEY` | *(未设置)* | 如果未设置，则回落到InternetDB（免费） | | `VT_API_KEY` | *(未设置)* | VirusTotal API密钥 | | `ABUSEIPDB_KEY` | *(未设置)* | AbuseIPDB API密钥 | | `ETHERSCAN_KEY` | *(未设置)* | Etherscan API密钥，用于ETH工具 | 要设置API密钥，请编辑`docker-compose.yml`中的`environment`部分并重启： ```bash docker compose up -d ``` --- ## 连接您的AI SPECTRE是一个标准的MCP Streamable-HTTP服务器。连接URL始终为`http://localhost:8001/mcp`. **Claude Code** ```bash claude mcp add spectre http://localhost:8001/mcp ``` **Gemini CLI** ```bash gemini mcp add --transport Streamable-HTTP, --trust spectre http://localhost:8001/mcp ``` **Cursor / Windsurf / Cline** 添加一个名为`Streamable-HTTP,`类型的新MCP服务器，URL为`http://localhost:8001/mcp`. **手动JSON配置** (`~/.claude/config.json` 或等效) ```json { "mcpServers": { "spectre": { "type": "Streamable-HTTP,", "url": "http://localhost:8001/mcp" } } } ``` --- ## 管理命令 | 操作 | 命令 | | :--- | :--- | | 启动（首次构建） | `docker compose up -d --build` | | 启动（后续） | `docker compose up -d` | | 停止 | `docker compose down` | | 查看实时日志 | `docker compose logs -f spectre` | | 进入容器shell | `docker exec -it spectre-mcp bash` | | 强制重建 | `docker compose up -d --build --force-recreate` | --- ## 堆栈 | 层 | 技术 | | :--- | :--- | | **基础镜像** | `kalilinux/kali-rolling` | | **MCP服务器** | FastMCP 2.3.3 + mcp[cli] 1.24.0 | | **传输** | Streamable-HTTP，端口8001 | | **Python工具** | sherlock，maigret，holehe，h8mail，ghunt，socialscan，scrapling，phoneinfoga，osrframework，shodan，dnspython | | **Go工具** | subfinder，httpx，nuclei，naabu，katana，tlsx，dnsx，waybackurls，gau，assetfinder，hakrawler，gospider | | **Kali软件包** | nmap，masscan，nikto，sqlmap，wpscan，gobuster，ffuf，hydra，john，hashcat，metasploit-framework，aircrack-ng，responder，netexec，impacket，enum4linux，和100+其他 | | **存储** | Docker卷`spectre-output`，挂载在`/tmp/spectre` | | **资源** | 512 MB预留 · 4 GB限制 | --- ## 故障排除 **端口8001连接被拒绝** 检查容器是否正在运行：`docker compose ps`. 查看启动错误：`docker compose logs spectre`. **您的AI CLI中的授权错误** 一些CLI提示您显式信任本地Streamable-HTTP终结点。接受提示或使用 `--trust` 标志（Gemini CLI）。 **特定工具返回错误或无输出** 一些工具可能无法在某些系统上安装。运行`spectre_status`查看哪些二进制文件可用。工具构建失败是非致命的；其他一切照常工作。 **API密钥错误（VirusTotal，AbuseIPDB，Etherscan）** 这些工具需要API密钥。在`docker-compose.yml`的`environment`下设置它们并重启容器。Shodan会自动回落到免费的InternetDB端点。 **DNS解析在`docker compose build`期间失败** 这是Docker守护进程的DNS问题，而不是运行时问题。在Docker Desktop设置 → 资源 → 网络 → DNS中配置DNS。参见 [Docker文档](https://docs.docker.com/desktop/settings/windows/#network). --- ## 免责声明 SPECTRE仅用于**授权的安全研究，渗透测试和教育用途**。作者不承担滥用责任。您单独负责确保在测试任何系统之前获得书面许可。 --- <div align="center"> *由* **ItisPhoenix** · *支持Kali Linux和开源工具* </div>