mcp-maltego

mcp-maltego

面向 AI Agent 的 Maltego OSINT。
使用 Claude、Gemini、Codex、Copilot、Cursor 或任何 MCP 客户端运行转换和 Machines、构建并分析关系图，并将结果以原生 .mtgx 格式交还给 Maltego。

mcp-maltego 是一款 模型上下文协议 服务，可将 AI Agent 转变为 Maltego 操作员。它可运行真实的转换（内置转换、商业提供商提供的转换，或你自己的 TRX/iTDS 服务），将它们串联成 Machines，通过记忆每一步来维护持久的调查关系图，推荐下一步的扩展方向，并将所有内容导出到 Maltego Desktop。你使用的每个 Agent 都共享同一个关系图。

主要功能

• 20 个工具，适用于各种模型。 扁平 JSON 架构通过 Gemini 严格的函数调用子集验证；使用 action 参数对变体进行分组，避免 Agent 被工具淹没。
• 开箱即用的 38 种真实转换。 其中 26 种无需 API 密钥（DNS over HTTPS、RDAP/WHOIS、通过 crt.sh 和 CertSpotter 提供的证书透明度、HackerTarget、urlscan.io、Shodan InternetDB、Team Cymru 和 RIPE Stat ASN/网段、Gravatar、GitHub 个人资料详情、AlienVault OTX 威胁脉冲、多网络个人资料查询、解析）；另外 12 种提供商转换会在设置密钥后启用：VirusTotal、Shodan、SecurityTrails、Censys、Hunter.io、Have I Been Pwned、GreyNoise 和 Tatum。
• 也支持 Maltego 转换。 使用 Maltego TRX/iTDS XML 协议，因此 Agent 可以运行你在 Maltego 中使用的相同转换。
• 机器。 DomainRecon、InfrastructureRecon、EmailRecon、CompanyFootprint、PersonalFootprint、PersonaFootprint、URLRecon、ThreatSweep、ASNToNetblocks，以及你用 TOML 编写的自定义机器，支持递归轮次和成本预算。
• HUMINT、泄露路由器和多 Agent 集群。 原生 humint.* 实体本体（humint.Alias、humint.Organization、humint.LocationHistory、humint.PsychologicalTrait）、跨平台化名关联、主体行为分析（[Hipótesis]）、按时间顺序检测异常、加权关系、本地 SQLite + k-Anonymity/XposedOrNot 泄露路由器（BreachSemanticPivot），以及支持乐观锁的多 Agent 案件 fork/delegate/merge。
• 调查副驾驶。 osint_investigate 通过一次调用完成检测、案件创建、选择合适的机器、评分和建议。每一步都会被记录（做了什么、针对什么、为什么、结果如何）；每个实体都有可解释的来源信息和优先级评分；下一步最佳操作会根据每项转换的表现进行学习。
• 原生 Maltego 往返支持。 导出 .mtgx，支持层级、径向或力导向布局，并嵌入调查记忆；导入 .mtgx；在 Maltego Desktop 中运行本地转换，以打开案件、扩展邻居并将实体发送回 Agent；导入你完整的 Maltego 实体本体。
• 报告和 CLI。 以 Markdown 或独立 HTML 格式生成执行摘要报告，并提供适用于终端和 CI 的 maltegoctl。
• 默认安全。 OSINT 内容会被视为不可信数据；使用 defusedxml 解析 XML；读取归档文件时会限制范围；Agent 无法提供任意 URL；API 密钥绝不会被记录。

要求

• Node.js 18 或更高版本（用于 npx）。
• uv — 自动管理 Python 3.12 运行时（如果尚未安装 uv，mcp-maltego 会在首次运行时自动将其安装到 ~/.maltego-mcp/bin）。

只需运行一条命令，即可准备运行时、~/.maltego-mcp/.env 模板、Maltego Desktop 桥接 .mtz，以及全局 CLI 启动器（mcp-maltego、maltego-mcp、maltegoctl、maltego-mcp-bridge，位于 ~/.local/bin / %USERPROFILE%\.local\bin，并添加到 PATH）：

npx -y mcp-maltego setup

你也可以在任何操作系统 / 发行版（Windows PowerShell/CMD、macOS、Ubuntu/Debian、Kali、Fedora/RHEL、Arch、Alpine）上选择特定的部署模式或客户端目标：

npx -y mcp-maltego setup --mode global              # (Default) Global CLI in ~/.local/bin + PATH (run from any directory)
npx -y mcp-maltego setup --mode local               # Isolated inside ~/.maltego-mcp without modifying PATH
npx -y mcp-maltego setup --mode http                # Prepare + print Streamable HTTP server startup
npx -y mcp-maltego setup --client claude            # Print ready-to-use config for a specific client (claude|gemini|codex|copilot|cursor|all)

入门

适用于大多数 MCP 客户端的标准配置：

{
  "mcpServers": {
    "maltego": {
      "command": "npx",
      "args": ["-y", "mcp-maltego"]
    }
  }
}

然后向你的 Agent 提问：

调查 example.com，给我案件摘要并将其导出供 Maltego 使用。

claude mcp add maltego -- npx -y mcp-maltego

codex mcp add maltego -- npx -y mcp-maltego

[mcp_servers.maltego]
command = "npx"
args = ["-y", "mcp-maltego"]

{ "servers": { "maltego": { "command": "npx", "args": ["-y", "mcp-maltego"] } } }

{ "mcp": { "maltego": { "type": "local", "command": ["npx", "-y", "mcp-maltego"], "enabled": true } } }

npx -y mcp-maltego --transport http --port 8000   # http://127.0.0.1:8000/mcp

entity_type 接受任何 Maltego 类型、自定义的 prefix.Name，或用于根据值自动检测类型的 "auto"。

转换

通过客户端的配置传递密钥：

{ "mcpServers": { "maltego": { "command": "npx", "args": ["-y", "mcp-maltego"],
  "env": { "SHODAN_API_KEY": "...", "VIRUSTOTAL_API_KEY": "..." } } } }

在 ~/.maltego-mcp/transforms.toml 中声明你自己的 Maltego 转换服务（TRX / iTDS）；参见 config/transforms.example.toml。自定义 Machines 也放在同一文件中。

Maltego 桌面应用集成

本地 transforms 可在 Maltego CE 和商业版中使用，无需 transform 服务。要使用桥接程序，请全局安装此包（npm i -g mcp-maltego），以确保命令路径保持稳定。详情请见 docs/MALTEGO.md。

配置

更多信息请见 docs/USO.md（西班牙语）。

CLI

npx mcp-maltego ctl inspect case.mtgx           # validate a .mtgx
npx mcp-maltego ctl lookup DomainToMX gmail.com  # quick lookup, nothing saved
npx mcp-maltego ctl transforms --type maltego.Domain
npx mcp-maltego ctl export demo --format report_html
npx mcp-maltego ctl import-entities config.mtz
npx mcp-maltego ctl mtz

示例提示词

• 调查 [email protected]，并告诉我接下来值得运行哪些关联查询。
• 对 example.com 运行 DomainRecon，进行两轮查询，实体预算为 200。
• 找出 IP 93.184.216.34 与案例 demo 中的电子邮件之间的所有路径。
• 以放射状布局导出案例 demo 供 Maltego 使用，并为我生成一份 HTML 报告。
• 将我在 Maltego 中保存为 acme.mtgx 的图导入案例 acme，并从那里继续。

面向贡献者和分析师的 AI Agent 与技能

此代码库提供 10 个 Agent 和 15 项技能，均由单一源文件（.agents/）生成，适用于 Claude Code、Gemini CLI、 Qwen Code、GitHub Copilot 和 Codex；技能采用开放的 Agent Skills 格式（Cursor 也能读取）：

• 调查 Agent（使用此 MCP）：osint-analyst（带有下一最佳操作循环和记忆功能的 Copilot）、 cti-analyst（防御性暴露分析和 IOC 分诊）、ioc-composer（使用 MISP、ATT&CK、TheHive、 Cortex 构建多 MCP IOC 图）、recon-toolchain-integrator（将 theHarvester、amass、recon-ng、SpiderFoot 的输出导入图中）。
• 调查技能：公司足迹、身份足迹、基础设施映射、IOC 图构建、外部 OSINT 工具、调查方法。
• 开发 Agent 和技能：MCP 工具设计、transforms 和自定义提供程序、Machines、图模型、 Maltego 格式、非标准实体、安全审查、测试、发布和部署。

灵感来自社区项目（SulimanAbdulrazzaq/maltego-mcp、lidless-labs/maltego-mcp、HexStrike AI、MCP-Kali-Rust）； 有意不涉及攻击性能力（漏洞利用）。

安全与负责任使用

OSINT 内容不可信，绝不会被当作指令执行。请参阅 SECURITY.md，了解设计 以及如何报告漏洞。你有责任遵守你所在司法管辖区的法律、各提供商的服务条款和数据保护规定 （例如 GDPR）。

开发

git clone https://github.com/Data-Unix/MCP-MALTEGO.git && cd MCP-MALTEGO
uv sync
uv run pytest -q && uv run ruff check . && uv run mypy src   # Python
npm test                                                       # npm launcher
npx @modelcontextprotocol/inspector uv run maltego-mcp        # inspect the server

架构、贡献者和 AI Agent 约定：AGENTS.md。功能规格覆盖情况：docs/COBERTURA.md。变更记录：CHANGELOG.md。

许可证

MIT。Maltego 是 Maltego Technologies GmbH 的商标。本项目独立运营，与 Maltego Technologies 无关联，也未获其认可。