メグレ MCP サーバー
様々な公開ソースからユーザーアカウント情報を収集する強力なOSINTツールである maigret用のモデルコンテキストプロトコル（MCP）サーバーです。このサーバーは、ソーシャルネットワーク上のユーザー名を検索したり、URLを分析するためのツールを提供します。Claude DesktopなどのMCP対応アプリケーションとシームレスに統合できるように設計されています。
⚠️ 警告
このツールは、正当なOSINT調査を目的として設計されています。以下の点にご注意ください。
- 公開されている情報のみを検索する
- プライバシーとデータ保護法を尊重する
- 検索対象のプラットフォームの利用規約に従ってください
- 責任を持って倫理的に使用してください
- 一部のサイトでは、自動検索のレート制限やブロックが行われる場合があるので注意してください。
要件
- Node.js (v18以降)
- ドッカー
- Docker Desktop がインストールされた macOS、Linux、または Windows
- レポートディレクトリへの書き込みアクセス権
クイックスタート
Smithery経由でインストール
Smithery経由で Claude Desktop に Maigret を自動的にインストールするには:
npx -y @smithery/cli install mcp-maigret --client claude
手動でインストールする
- Docker をインストールします。
- npm 経由でサーバーをグローバルにインストールします。
npm install -g mcp-maigret
- レポート ディレクトリを作成します。
mkdir -p /path/to/reports/directory
- Claude Desktop 構成ファイルに以下を追加します:
{
"mcpServers": {
"maigret": {
"command": "mcp-maigret",
"env": {
"MAIGRET_REPORTS_DIR": "/path/to/reports/directory"
}
}
}
}
構成ファイルの場所:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- Claudeデスクトップを再起動します
代替セットアップ（ソースから）
ソースから実行したい場合、またはコードを変更する必要がある場合:
- クローンとビルド:
git clone <repository_url>
cd mcp-maigret
npm install
npm run build
- Claude Desktop 構成に追加:
{
"mcpServers": {
"maigret": {
"command": "node",
"args": ["/absolute/path/to/mcp-maigret/build/index.js"],
"env": {
"MAIGRET_REPORTS_DIR": "/path/to/reports/directory"
}
}
}
}
特徴
- ユーザー名検索: 何百ものソーシャル ネットワークやウェブサイトでユーザー名を検索します
- URL分析: URLを解析して情報を抽出し、関連するユーザー名を検索します
- 複数の出力形式: txt、html、pdf、json、csv、xmind 形式をサポート
- サイトフィルタリング: サイトタグ（例: 写真、デート、私たち）で検索をフィルタリングします
- Dockerベース: 環境間で信頼性と一貫性のある実行
ツール
1. ユーザー名検索ツール
- 名前:
search_username - 説明: ソーシャルネットワークやサイト全体でユーザー名を検索します
- パラメータ:
username （必須）: 検索するユーザー名format （オプション、デフォルト: "pdf"）: 出力形式（txt、html、pdf、json、csv、xmind）use_all_sites (オプション、デフォルト: false): 上位 500 の代わりに利用可能なすべてのサイトを使用するtags (オプション): サイトをフィルタリングするためのタグの配列 (例: ["photo", "dating"])
例：
{
"username": "test_user123",
"format": "html",
"use_all_sites": false,
"tags": ["photo"]
}
2. URL分析ツール
- 名前:
parse_url - 説明: URL を解析して情報を抽出し、関連するユーザー名を検索します
- パラメータ:
url (必須): 分析するURLformat （オプション、デフォルト: "pdf"）: 出力形式（txt、html、pdf、json、csv、xmind）
例：
{
"url": "https://example.com/profile",
"format": "txt"
}
トラブルシューティング
Dockerの問題
- Docker がインストールされ、実行されていることを確認します。
docker --version
docker ps
- Docker の権限を確認します。
- ユーザーにDockerコマンドを実行する権限があることを確認する
- Linuxでは、ユーザーをdockerグループに追加します:
sudo usermod -aG docker $USER
ディレクトリの問題を報告する
- レポート ディレクトリを確認します。
- MAIGRET_REPORTS_DIRで指定されたディレクトリが存在する必要があります
- ユーザーはこのディレクトリへの書き込み権限を持っている必要があります
- 権限を確認する:
ls -la /path/to/reports/directory
- よくある設定ミス:
- MAIGRET_REPORTS_DIR 環境変数がありません
- ディレクトリが存在しません
- 権限が正しくありません
- パスの末尾のスラッシュ
- 問題を修正した後:
- 設定ファイルを保存する
- Claudeデスクトップを再起動します
エラーメッセージ
- 「Dockerがインストールされていないか、実行されていません」: Dockerをインストールし、Dockerデーモンを起動します
- 「MAIGRET_REPORTS_DIR環境変数を設定する必要があります」: 設定に環境変数を追加します
- 「レポートディレクトリの作成エラー」: ディレクトリの権限とパスを確認してください
- 「maigret 実行エラー」: Docker ログを確認し、コンテナに適切な権限があることを確認してください
貢献
- リポジトリをフォークする
- 機能ブランチを作成する (
git checkout -b feature/amazing-feature ) - 変更をコミットします（
git commit -m 'Add amazing feature' ） - ブランチにプッシュする (
git push origin feature/amazing-feature ) - プルリクエストを開く
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。