theHarvester MCP について
theHarvester MCP は theHarvester をラップし、AI エージェントによるドメイン関連の公開 OSINT 情報収集を可能にします。見込み顧客の調査、資産把握、許可を得たセキュリティ調査向けで、非同期収集と結果取得に対応します。
主な機能
- 01公開メールアドレスとホスト名の収集
- 02サブドメインと IP アドレスの収集
- 03設定可能なソースでの情報収集
- 04収集 ID による結果取得
- 05ソースと実行中タスクの一覧表示
活用シーン
- 01営業調査向けの公開連絡先検索
- 02ドメインと関連資産の把握
- 03許可を得たセキュリティ評価でのドメイン調査
MCP 対応
MCP サーバーは、ドメイン収集の実行、過去の結果取得、実行中タスクの確認、ソース一覧表示のツールを公開します。stdio トランスポートを使用し、提供される Docker イメージで実行できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
docker run -i --rm -e THEHARVESTER_TIMEOUT -e THEHARVESTER_MAX_CONCURRENT docker.io/devkind/theharvester-mcp:1.0.0THEHARVESTER_TIMEOUTPer-harvest timeout in seconds (default 120)THEHARVESTER_MAX_CONCURRENTMaximum concurrent harvests (default 2)ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
theHarvester MCP サーバー:AI エージェント向けのOSINTによるメールアドレスとサブドメインの発見
theHarvester MCP サーバーは、theHarvesterを Model Context Protocolサーバーとして利用できるようにするもので、Claude Code、Cursor、その他の MCP クライアントから、必要に応じてドメインの公開メールアドレス、サブドメイン、ホスト名、IPアドレス、LinkedInプロフィールを収集できます。マルチアーキテクチャ対応のDockerイメージ、stdioトランスポートを備え、デフォルトの無料ソースではAPIキーは不要です。
リードの獲得と見込み客の開拓を目的に構築されています。エージェントに「example.comの公開連絡先を見つけて」と尋ねると、harvestツールを呼び出し、crtsh、hackertarget、urlscan、DuckDuckGoなどのソースを並列に検索して、構造化JSONを返します。収集処理は設定可能な並列実行数とタイムアウトで非同期に実行され、結果は収集IDで取得できます。
クイックスタート
docker pull devkind/theharvester-mcp
.mcp.json(Claude Code)またはMCPクライアントの設定に追加します。
{
"mcpServers": {
"theharvester": {
"command": "docker",
"args": ["run", "--rm", "-i", "devkind/theharvester-mcp"]
}
}
}
次に、エージェントに「無料ソースを使ってexample.comを調べて」と依頼します。
クライアントへのインストール
要件:
- Docker
- Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、またはその他のMCPクライアント
- デフォルトの無料ソースではAPIキーは不要です
ほとんどのMCPクライアントでは、標準設定を使用できます。
{
"mcpServers": {
"theharvester": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"devkind/theharvester-mcp"
]
}
}
}
Claude Desktop
MCPのインストールガイドに従い、上記の標準設定をclaude_desktop_config.jsonに追加します。
Claude Code
次を実行します。
claude mcp add theharvester -- docker run --rm -i devkind/theharvester-mcp
または、上記の標準設定をプロジェクトのルートにある.mcp.jsonに追加します。
Cursor
ボタンをクリックしてインストールします:
または手動でインストールします:
Cursor Settings -> MCP -> Add new MCP Serverに移動します。名前を「theHarvester MCP」にし、タイプにcommandを指定して、コマンドにdocker run --rm -i devkind/theharvester-mcpを設定します。
VS Code
MCPのインストールガイドに従い、上記の標準設定を使用します。VS Code CLIを使ってインストールすることもできます。
code --add-mcp '{"name":"theharvester","command":"docker","args":["run","--rm","-i","devkind/theharvester-mcp"]}'
Windsurf
WindsurfのMCPドキュメントに従い、上記の標準設定を使用します。
Goose
Advanced settings -> Extensions -> Add custom extensionに移動します。名前を「theHarvester MCP」にし、タイプにSTDIOを指定して、commandにdocker run --rm -i devkind/theharvester-mcpを設定します。「Add Extension」をクリックします。
LM Studio
右側のサイドバーでProgram -> Install -> Edit mcp.jsonに移動します。上記の標準設定を使用します。
Warp
Settings -> AI -> Manage MCP Servers -> + Addに移動して、MCPサーバーを追加します。上記の標準設定を使用するか、Warpのプロンプトでスラッシュコマンド/add-mcpを使い、設定を貼り付けます。
ツール
| ツール | 機能 |
|---|---|
harvest | ドメインのOSINT調査を実行します(ソース:free、all、またはカンマ区切りで指定) |
get_harvest_results | IDを指定して、以前の調査結果を取得します |
list_active_harvests | 現在実行中の調査を表示します |
list_sources | 利用可能なすべてのソースと、APIキーが必要なソースを一覧表示します |
crtsh、hackertarget、dnsdumpster、rapiddns、urlscan、otx、duckduckgoの7つのソースはAPIキーなしで利用できます。shodan、censys、virustotalなどのソースでは、theHarvesterのインストール環境でキーを設定する必要があります。
呼び出し例と出力
ツール呼び出し:harvest に {"domain": "example.com", "sources": "free"} を指定
{
"harvest_id": "a1b2c3d4",
"domain": "example.com",
"status": "completed",
"duration_seconds": 42.5,
"sources_used": ["crtsh", "hackertarget", "urlscan"],
"summary": {"emails": 3, "hosts": 27, "ips": 12, "linkedin": 2},
"emails": ["[email protected]", "[email protected]", "[email protected]"],
"hosts": ["www.example.com", "api.example.com", "mail.example.com"]
}
出力は例示用です。実際の件数は対象ドメインとソースの利用状況によって異なります。
harvest ツールは domain(必須)、sources(free、all、またはカンマ区切りのリスト)、limit、timeout を受け付けます。無効なドメインは、ネットワークへのアクセス前に拒否されます。
設定
環境変数:THEHARVESTER_TIMEOUT(デフォルトは120s)、THEHARVESTER_MAX_CONCURRENT
(デフォルトは2)、THEHARVESTER_OUTPUT_DIR(デフォルトは/app/output)。
責任ある利用
theHarvester は公開されている情報のみを収集しますが、OSINT ツールは厳しく監視されています。 このサーバーは、ご自身が所有するドメイン、または調査の書面による許可を得ているドメインに対して、セキュリティ評価、資産目録の作成、公開されている企業の連絡先データを対象とした営業活動など、合法的な目的に限って使用してください。収集した連絡先を利用する際は、各ソースの利用規約、および適用されるプライバシー法と迷惑メール対策法(GDPR、CAN-SPAM、PECA)を遵守してください。メンテナーは不正利用に対して責任を負いません。
ロードマップ
- 公式 MCP レジストリへの掲載(
io.github.devkindhq/theharvester-mcp) - Docker MCP Registry、Smithery、Glama への掲載
-
latestと並行して theHarvester のバージョンを固定(devkind/theharvester-mcp:<version>は theHarvester 4.11.1 を使用してビルドされ、latestは最新リリースを追跡します) - タグ付け時にマルチアーキテクチャイメージをビルドしてプッシュする CI ワークフロー(最初のタグ付けまでは未テスト)
ライセンスとコントリビューション
MIT © Devkind。問題や PR を歓迎します。CONTRIBUTING.md と SECURITY.md をご覧ください。
Devkind が開発しました。Kazim Ali がメンテナンスしています。
OSINT とリード生成をスタックに組み込みませんか?
Devkind は、カスタム MCP サーバー、AI エージェントのワークフロー、コマース連携を構築しています。このような情報収集を CRM、データ補完、またはアウトリーチ用ツールに組み込みたい場合は、Devkind にご相談ください。または [email protected] までメールでお問い合わせください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。