mcp-maltego

mcp-maltego

AI エージェント向けの Maltego OSINT。
Claude、Gemini、Codex、Copilot、Cursor、または任意の MCP クライアントから、トランスフォームや Machine を実行し、リンクグラフを構築・分析して、結果をネイティブ形式の .mtgx として Maltego に戻せます。

mcp-maltego は、AI エージェントを Maltego オペレーターにする Model Context Protocol サーバーです。実際のトランスフォーム（組み込みのもの、商用プロバイダーのもの、または独自の TRX/iTDS サーバー）を実行し、それらを Machine に連結し、あらゆる手順の記録を保持する永続的な調査グラフを維持して、次のピボットを提案し、すべてを Maltego Desktop にエクスポートします。使用するすべてのエージェントで、1 つのグラフを共有します。

主な機能

• 20 個のツールで、あらゆるモデルに対応します。 Gemini の厳格な関数呼び出しサブセットに照らして検証されるフラットな JSON スキーマを採用しています。バリエーションは action パラメーターでグループ化されているため、エージェントに大量のツールを提示せずに済みます。
• すぐに使える実際の変換機能が 38 種類あります。 API キーなしで利用できる機能が 26 種類（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 プロトコルに対応しているため、エージェントは Maltego で使うものと同じ変換機能を実行できます。
• Machines。 DomainRecon、InfrastructureRecon、EmailRecon、CompanyFootprint、PersonalFootprint、PersonaFootprint、URLRecon、ThreatSweep、ASNToNetblocks、および TOML で定義する独自の Machine に対応し、再帰的なラウンドとコスト予算も利用できます。
• HUMINT、Breach Router、マルチエージェントスウォーム。 ネイティブの humint.* エンティティオントロジー（humint.Alias、humint.Organization、humint.LocationHistory、humint.PsychologicalTrait）、プラットフォームを横断した仮名の相関付け、対象の行動プロファイリング（[Hipótesis]）、時系列の異常検知、重み付けされた関係性、ローカル SQLite + k-Anonymity/XposedOrNot による侵害ルーター（BreachSemanticPivot）、および楽観的ロックを用いたマルチエージェントによるケースの fork／delegate／merge に対応します。
• 調査コパイロット。 osint_investigate を呼び出すだけで、検出、ケース作成、適切な Machine の選択、スコアリング、推奨事項の提示を行います。すべての手順（何を、何に対して、なぜ実行し、どのような結果になったか）が記録され、各エンティティには説明可能な来歴と優先度スコアが付与されます。また、次善のアクションは各変換機能の実績から学習します。
• ネイティブの Maltego ラウンドトリップ。 階層型、放射状、または力指向レイアウトで、調査の記憶を埋め込んだ .mtgx をエクスポートできます。.mtgx のインポート、Maltego Desktop 内のローカル変換機能によるケースのオープン、近隣エンティティの展開、エンティティのエージェントへの送信、および使用中の Maltego エンティティオントロジーのインポートにも対応します。
• レポートと CLI。 Markdown または単体で動作する HTML 形式のエグゼクティブレポートを作成でき、ターミナルや CI では maltegoctl を利用できます。
• デフォルトで安全です。 OSINT の内容は信頼できないデータとして扱われ、XML は defusedxml で解析され、アーカイブは上限付きで読み込まれます。エージェントが任意の URL を指定することはできず、API キーがログに記録されることもありません。

要件

• Node.js 18 以降（npx 用）。
• uv — Python 3.12 のランタイムを自動で管理します（まだ uv がインストールされていない場合、初回実行時に mcp-maltego が ~/.maltego-mcp/bin に自動でインストールします）。

ランタイム、~/.maltego-mcp/.env テンプレート、Maltego Desktop ブリッジ .mtz、グローバル CLI ランチャー（~/.local/bin または %USERPROFILE%\.local\bin 内の mcp-maltego、maltego-mcp、maltegoctl、maltego-mcp-bridge を PATH に追加）を、次の 1 つのコマンドで準備できます。

npx -y mcp-maltego setup

また、どの OS／ディストリビューション（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"]
    }
  }
}

次に、エージェントに次のように依頼します：

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 トランスフォームサーバー（TRX／iTDS）は ~/.maltego-mcp/transforms.toml で宣言します。詳しくは config/transforms.example.toml を参照してください。カスタム Machines も同じファイルに記述します。

Maltego Desktop との統合

ローカルトランスフォームは、トランスフォームサーバーなしで Maltego CE および商用エディションで動作します。ブリッジを使用するには、 コマンドパスを安定させるため、パッケージをグローバルにインストールしてください（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 を 2 ラウンド、エンティティ数の上限を 200 にして実行してください。
• IP アドレス 93.184.216.34 とケース demo 内のメールアドレスの間にあるすべての経路を見つけてください。
• ケース demo を放射状レイアウトで Maltego 用にエクスポートし、HTML レポートを作成してください。
• Maltego で acme.mtgx として保存したグラフをケース acme にインポートし、そこから続けてください。

コントリビューターとアナリスト向けの AI エージェントとスキル

このリポジトリには、単一のソース（.agents/）から生成された 10 個のエージェントと 15 個のスキルが含まれており、Claude Code、Gemini CLI、 Qwen Code、GitHub Copilot、Codex 向けに用意されています。スキルはオープンな Agent Skills 形式で、 Cursor でも読み込めます。

• 調査エージェント（この 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 ツール、調査手法。
• 開発エージェントとスキル：MCP ツールの設計、トランスフォームとカスタムプロバイダー、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 エージェント向けの規約：AGENTS.md。機能仕様の網羅状況：docs/COBERTURA.md。変更履歴：CHANGELOG.md。

ライセンス

MIT。Maltego は Maltego Technologies GmbH の商標です。このプロジェクトは独立したものであり、Maltego Technologies と提携関係になく、同社による推奨も受けていません。