Maigret MCP Server

クイックスタート · ツール · 形式 · セキュリティ · トラブルシューティング · ドキュメント

mcp-maigret は、AI エージェントが maigret を実行できる MCP サーバーです。maigret は、数千のサイトでユーザー名を検索する OSINT ツールです。ハンドル名がどこに登録されているかの検索や、プロフィール URL の分析をエージェントに依頼すると、保存されたレポートを受け取れます。maigret は Docker で実行されるため、Docker と Node 以外にインストールするものはありません。

警告

これは、公開情報を対象とした正当かつ許可済みの OSINT 調査に使用してください。法律および各サイトの利用規約に従い、個人のプライバシーを尊重してください。一部のサイトでは、自動検索の頻度が制限されたり、ブロックされたりする場合があります。

特長

• ユーザー名検索。数百から数千のサイトを対象に検索でき、タグ（photo、dating、us、……）で絞り込めます。
• URL 分析。プロフィール URL を渡すと、maigret が可能な情報を抽出し、関連するユーザー名を検索します。
• 6 種類のレポート形式（txt、html、csv、json、xmind、pdf）。指定したディレクトリに保存されます。現在利用できる形式をご確認ください。
• 強化された入力処理。厳格な検証と、引数配列を使った execFile を採用しています。シェルは一切使用しません。セキュリティをご覧ください。
• Docker ベース。初回使用時に maigret イメージが取得されるため、どのマシンでも同じ maigret が実行されます。

仕組み

flowchart LR
    A["AI agent<br/>(Claude Desktop, Claude Code, any MCP client)"] -->|"MCP over stdio"| S["mcp-maigret"]
    S -->|"validate input,<br/>execFile docker run"| D["soxoj/maigret<br/>(Docker)"]
    D -->|"checks sites"| W(("Public<br/>websites"))
    D -->|"writes report"| R[("MAIGRET_REPORTS_DIR")]
    S -->|"report path + scan output"| A

クイックスタート

要件： Node.js 18 以降、およびインストール済みで実行中の Docker。macOS で開発・テストされています。Linux と Windows（Docker Desktop）でも動作するはずですが、テストされていません。

1. レポート保存先ディレクトリを選択します。 サーバーはここにレポートを保存します。ディレクトリがない場合は作成されます。この変数は必須です。

export MAIGRET_REPORTS_DIR="$HOME/maigret-reports"

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

claude mcp add maigret -e MAIGRET_REPORTS_DIR="$HOME/maigret-reports" -- npx -y mcp-maigret

{
  "mcpServers": {
    "maigret": {
      "command": "npx",
      "args": ["-y", "mcp-maigret"],
      "env": { "MAIGRET_REPORTS_DIR": "/absolute/path/to/maigret-reports" }
    }
  }
}

npx -y @smithery/cli install mcp-maigret --client claude

git clone https://github.com/w0h1v/mcp-maigret && cd mcp-maigret
npm install && npm run build

3. 試してみましょう。 エージェントに次のように依頼します。「maigret を使って、ユーザー名 octocat がどこに登録されているか、coding タグに絞って調べてください。」

初回の検索では maigret イメージ（約 800 MB）が取得されるため、時間がかかります。

ツール

search_username

ソーシャルネットワークやサイト全体からユーザー名を検索します。

{ "username": "octocat", "format": "html", "tags": ["coding"] }

結果には、保存されたレポートのパスとmaigretのコンソール出力が含まれます。レポートファイルが生成されなかった場合は、成功を報告する代わりに、その旨が結果に表示されます。

parse_url

URLを解析し、情報を抽出して、関連するユーザー名を検索します。

{ "url": "https://github.com/octocat" }

結果は、maigretのスキャン出力テキストとして返されます。

出力形式

レポートはMAIGRET_REPORTS_DIRに書き込まれます。ファイル名はMaigretが決定し、形式によっては接尾辞が追加されます。Maigretが関連するユーザー名を見つけた場合、メインのレポートと同じ場所に追加のレポートを書き込むことがあります（例：report_octocatsup.txt）。

状態はmaigret 0.6.6（イメージsoxoj/maigret:latest、2026年10月）で確認しています。Maigretのコマンドラインはリリースごとに変更されるため、状況が変わる可能性があります。

セキュリティ

ユーザー名、URL、タグはAIエージェントから渡されるため、信頼できない入力として扱います。

• 検証。 ユーザー名に使用できるのは[A-Za-z0-9_.-]のみです（最大100文字）。タグに使用できるのは[A-Za-z0-9_-]のみです（最大50文字）。URLはhttpまたはhttpsとして解析でき、シェルのメタ文字を含まない必要があります。
• シェルを使用しません。 Dockerの起動にはexecFileと引数配列を使用し、連結したコマンド文字列は使用しません。
• 書き込み範囲の制限。 レポートはコンテナから、マウントした単一のディレクトリに書き込まれます。サーバーはそれ以外の場所を読み書きしません。

この仕組みで対処できないこと：サーバーはエージェントに代わってお使いのマシン上でDockerを実行し、お使いのIPアドレスから多数のサードパーティサイトにネットワークリクエストを送信します。信頼できるエージェントとクライアントに対してのみ実行してください。

脆弱性を発見した場合は、非公開で報告してください。SECURITY.mdを参照してください。

トラブルシューティング

詳細はドキュメントをご覧ください。

コントリビューション

コントリビューションを歓迎します。CONTRIBUTING.mdから始めてください。

• 変更履歴
• 質問とサポート：SUPPORT
• セキュリティに関する報告：SECURITY.md（非公開のアドバイザリーを利用し、公開 issue は作成しないでください）

ライセンス

MIT。maigret プロジェクトとは無関係の独立したプロジェクトです。Maigret は soxoj によるもので、独自のライセンスがあります。