OSINT Toolbox

osint-toolbox-mcp

AI エージェントが、お使いのマシン上で従来型の OSINT ツールを実行できる MCP サーバーです。Sherlock、Maigret、Blackbird、Holehe、GHunt、theHarvester、SpiderFoot、subfinder、dnstwist、dnsrecon、PhoneInfoga、ExifTool に加え、組み込みの WHOIS、DNS、証明書の透明性、Wayback Machine の検索に対応しています。API キーも、間に入るクラウドサービスも不要です。ツールはローカルで実行され、公開ソースに直接問い合わせます。

アシスタントに「[email protected] でアカウントを作成しているサイトはどこですか？」や「example.com について何が分かりますか？」と尋ねると、ツールを選んで実行し、結果を確認してくれます。

機能

インストール済みのツールのみがエージェントに提供されます。実行時間は数秒から最長で 30 分（SpiderFoot の全スキャン）です。リクエストは並列で実行され、キャンセルできます。

クイックスタート

次のいずれかを選択してください。

• Docker：Blackbird 以外のすべてのツールを 1 つのイメージに収録しており、ほかにインストールするものはありません。
• uvx：管理者権限なしで、1 つのコマンドからマシンにツールをインストールできます。

Docker

イメージのサイズが大きいため、サーバーを追加する前に一度プルしてください。そうしないと、初回起動時にクライアントの待ち時間を超えることがあります。

docker pull ghcr.io/renkagod/osint-toolbox-mcp

サーバーをクライアントに追加します。

{
  "mcpServers": {
    "osint-toolbox": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/renkagod/osint-toolbox-mcp"]
    }
  }
}

ExifTool 用のファイル、GHunt のログイン情報、API キー、プロキシについては、Docker の詳細をご覧ください。

uvx

uv をインストールしてから、ツールをインストールします。不足しているものをすべてインストールし、各ツールが起動することを確認します。内容については、ツールのインストールをご覧ください。

uvx osint-toolbox-mcp --install

クライアントにサーバーを追加します。

{
  "mcpServers": {
    "osint-toolbox": {
      "command": "uvx",
      "args": ["osint-toolbox-mcp"]
    }
  }
}

リリースではなく main の最新コードを実行するには、uvx --from git+https://github.com/renkagod/osint-toolbox-mcp osint-toolbox-mcp を使用します。

クライアントを接続する

ワンクリックでインストール：

クライアント	Docker（Blackbird 以外すべて）	uvx（使用するツール）
Cursor
VS Code
VS Code Insiders
LM Studio

Claude Desktop： 最新リリースから osint-toolbox-mcp-<version>.mcpb をダウンロードして開きます。Claude Desktop はこれを拡張機能としてインストールし、SpiderFoot、Blackbird、ExifTool の場所を任意で指定するよう求めます。その他のツールは PATH から検出されます。上記の JSON を Settings → Developer → Edit Config に貼り付けることもできます。

Claude Code：

claude mcp add osint-toolbox -- uvx osint-toolbox-mcp
claude mcp add osint-toolbox -- docker run -i --rm ghcr.io/renkagod/osint-toolbox-mcp

上記の mcpServers JSON を読み込むクライアント（ファイルに貼り付けてください）：

独自の形式を使うクライアント（uvx の例を表示しています。Docker の場合は、引数 run -i --rm ghcr.io/renkagod/osint-toolbox-mcp とともに docker を使用してください）：

{
  "servers": {
    "osint-toolbox": {
      "type": "stdio",
      "command": "uvx",
      "args": ["osint-toolbox-mcp"]
    }
  }
}

codex mcp add osint-toolbox -- uvx osint-toolbox-mcp

[mcp_servers.osint-toolbox]
command = "uvx"
args = ["osint-toolbox-mcp"]
tool_timeout_sec = 1800

{
  "context_servers": {
    "osint-toolbox": {
      "command": "uvx",
      "args": ["osint-toolbox-mcp"],
      "env": {}
    }
  }
}

extensions:
  osint-toolbox:
    name: osint-toolbox
    type: stdio
    cmd: uvx
    args: [osint-toolbox-mcp]
    enabled: true
    timeout: 1800

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "osint-toolbox": {
      "type": "local",
      "command": ["uvx", "osint-toolbox-mcp"],
      "enabled": true
    }
  }
}

name: OSINT Toolbox
version: 1.0.0
schema: v1
mcpServers:
  - name: osint-toolbox
    type: stdio
    command: uvx
    args:
      - osint-toolbox-mcp

ツールをインストールする

Blackbird を使う場合を除き、Docker を使う場合はスキップしてください。

uvx osint-toolbox-mcp --install

不足しているツールをすべて管理者権限なしでインストールし、それぞれが起動することを確認します。uvx osint-toolbox-mcp --install sherlock maigret を実行すると、指定したツールのみがインストールされます。これには uv が必要です。また、以下の処理を行います。

• 各 Python ツール（Sherlock、Holehe、Maigret、GHunt、theHarvester、dnstwist、dnsrecon）を、Python 3.12 上で uv tool install を使って、それぞれ独立した環境にインストールします。これらの依存関係は互いに競合し、新しい Python ではビルドできないものもあるためです。theHarvester と dnsrecon は、GitHub の最新リリースから取得します。
• SpiderFoot と Blackbird を GitHub からダウンロードし、それぞれに独自の仮想環境を用意します。
• PhoneInfoga、subfinder、ExifTool をダウンロードし、作者が公開しているチェックサムと照合します。macOS と Linux では、ExifTool に Perl が必要ですが、通常これらのシステムにはインストールされています。

チェックアウトとダウンロードは、Windows では %LOCALAPPDATA%\osint-toolbox-mcp、macOS では ~/Library/Application Support/osint-toolbox-mcp、Linux では ~/.local/share/osint-toolbox-mcp に保存されます。別のフォルダーを使うには、OSINT_TOOLBOX_HOME を設定してください。サーバーはこの場所を自動的に参照します。GHunt では、その後に一度だけ ghunt login を実行する必要があります。

uvx osint-toolbox-mcp --check を実行すると、いつでもすべてのツールの状態が ok、missing（インストール方法を表示）、または broken（見つかったものの起動に失敗）として表示されます。エージェントは osint_toolbox_status ツールを使って同じ情報を取得できます。

手動でのインストール

Python ツールを既定の Python でビルドできない場合は、uv tool install に --python 3.12 を追加してください。

SpiderFoot と Blackbird は、git のチェックアウトから実行します。それぞれ専用の .venv を作成してください。サーバーはこれを自動的に検出します。また、チェックアウトの場所をサーバーに指定します。

git clone https://github.com/smicallef/spiderfoot
cd spiderfoot
uv venv --python 3.12
uv pip install -r requirements.txt

次に、クライアントの設定（env）で OSINT_SPIDERFOOT_DIR にそのフォルダーを設定します。Blackbird も同様に、https://github.com/antoniaci/blackbird と OSINT_BLACKBIRD_DIR を使います。SpiderFoot では lxml<5 が固定されており、Python 3.13 以降ではビルドできません。より新しい Python を使うには、先に patches/spiderfoot-requirements.patch を適用してください。

設定

すべての設定は環境変数で、クライアントの設定の env ブロックに設定します。

{
  "mcpServers": {
    "osint-toolbox": {
      "command": "uvx",
      "args": ["osint-toolbox-mcp"],
      "env": {
        "OSINT_SPIDERFOOT_DIR": "/home/me/spiderfoot",
        "OSINT_EXIFTOOL": "/opt/exiftool/exiftool"
      }
    }
  }
}

PATH 以外にも、サーバーは --install フォルダーと、uv tool および pipx のインストール先フォルダー（デフォルトでは ~/.local/bin）を検索します。デスクトップアプリでは、これらが PATH に含まれていないことがよくあります。

Docker の詳細

• Blackbird はイメージに含まれていません。再配布を許可するライセンスがないためです。使用するには、自分でインストールしてください。

• ExifTool：コンテナーから見えるのはマウントされたファイルのみです。引数に -v /path/to/files:/data:ro を追加し、/data/photo.jpg について尋ねてください。

• GHunt：名前付きボリュームに一度ログインしてから、マウントしてください。

  docker run -it --rm --entrypoint ghunt -v osint-toolbox-ghunt:/home/osint/.malfrats ghcr.io/renkagod/osint-toolbox-mcp login
  

  GHunt のリスニングモード（オプション 1）はコンテナー内では動作しません。オプション 2（GHunt Companion 拡張機能から貼り付ける）またはオプション 3（oauth_token。GHunt の READMEを参照）を選択してください。

• API キー：theHarvester は /home/osint/.theHarvester/api-keys.yaml を読み込みます（ファイルをそこにマウントしてください）。PhoneInfoga は環境変数（-e NAME=value）からキーを読み込みます。

• プロキシ：例：-e HTTPS_PROXY=http://host.docker.internal:8080。

• タグ：リリースには latest および 1.0.0 などのバージョンタグ、現在の main には edge を使用します。linux/amd64 および linux/arm64 向けにビルドされています。

設定全体：

{
  "mcpServers": {
    "osint-toolbox": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/home/me/osint-files:/data:ro",
        "-v", "osint-toolbox-ghunt:/home/osint/.malfrats",
        "ghcr.io/renkagod/osint-toolbox-mcp"
      ]
    }
  }
}

リクエスト例

• 「[email protected] でアカウントが登録されているサイトはどこですか？」
• 「Sherlock と Maigret でユーザー名 jdoe_1987 を検索し、見つかった内容を比較してください。」
• 「example.com で公開されているサブドメインとメールアドレスは何ですか？」
• 「example.com に似たドメインのうち、登録されているものはどれですか？また、その中にメールサーバーを持つものはありますか？」
• 「example.com の所有者と有効期限を教えてください。2015 年当時のホームページの表示も見せてください。」
• 「/home/me/photo.jpg のメタデータを読み取り、どこで何を使って撮影されたのか教えてください。」
• 「example.com のパッシブな SpiderFoot スキャンを実行し、調査結果を要約してください。」

トラブルシューティング

• ツールが見つかりません。 uvx osint-toolbox-mcp --install を実行するか、ツールが見つからない理由を確認するには --check を実行してください（イメージの場合は docker run --rm ghcr.io/renkagod/osint-toolbox-mcp --check）。インストール後、クライアントを再起動して新しいツールが一覧に表示されるようにしてください。デスクトップアプリは、ターミナルより短い PATH でサーバーを起動することがよくあります。ツールの OSINT_* 変数には、フルパスを設定してください。
• 長時間のスキャンがタイムアウトします。 多くのクライアントは、1 分ほどでツールの応答待ちを終了します。クライアントで設定できる場合は、上限を引き上げてください。Claude Code ではミリ秒単位の MCP_TOOL_TIMEOUT、Codex CLI では tool_timeout_sec、Gemini CLI ではサーバーエントリのミリ秒単位の timeout、Goose では秒単位の timeout を設定します。それ以外の場合は、より短時間で実行できる方法を指定してください。たとえば、SpiderFoot の passive スキャンや、all_sites を指定しない Maigret などです。
• GHunt が失敗します。 有効なログインが必要です。ghunt login を実行してください。保存されたセッションが無効にされている場合、ghunt login 自体が失敗します。その場合は、ghunt login --clean を実行してセッションを削除し、その後 ghunt login を実行してください。
• 結果が空、エラーが発生する、または CAPTCHA が表示されます。 サイトではレート制限が行われ、ページが変更されることがあります。時間をおいて再試行するか、負荷を下げるか、プロキシを経由してください。サーバーの外でも同じようにツールが失敗する場合は、そのツールのプロジェクトに報告してください。
• Windows と .bat または .cmd ラッパー。 これらのラッパーに渡す引数は cmd.exe を経由するため、サーバーは & や | などの文字を含む入力を拒否します。OSINT_* 変数には、実際の実行ファイルを指定してください。

責任ある利用

これらのツールは、実在する人々や組織に関する情報を収集します。適法な根拠と権限がある場合に限り使用してください。対象となるのは、自分のアカウント、範囲内のセキュリティ評価、プライバシー法（GDPR、CCPA、および地域の同等法令）と各サイトの利用規約を尊重した調査です。誰かをつきまとったり、嫌がらせをしたり、個人情報を暴露したり、その他の方法で危害を加えたりする目的では使用しないでください。実行する内容と、結果の利用方法については、利用者自身が責任を負います。

貢献

課題やプルリクエストを歓迎します。CONTRIBUTING.md をご覧ください。脆弱性は、SECURITY.md に記載の方法で非公開で報告してください。変更内容は変更履歴に記載されています。

クレジット

各ツールの権利はそれぞれの作者に帰属し、各自のライセンスが適用されます：Sherlock、Maigret、Holehe、GHunt、theHarvester、SpiderFoot、Blackbird、PhoneInfoga、ExifTool。サーバーはこれらを個別のプログラムとして起動します。Docker イメージには変更を加えずに収録されています。

このプロジェクトは、frishtik/osint-tools-mcp-server（MIT）を出発点としています。

サポート

このプロジェクトがお役に立ちましたら、暗号資産で支援できます：寄付先アドレス。

ライセンス

MIT — Copyright (c) 2026 renkagod。