Maigret OSINT

🚀 Maigret MCP 服務器

這是一個與 maigret 工具兼容的 MCP 服務器，具備用戶名搜索、URL 分析功能，還支持多種輸出格式，能滿足不同場景的需求。

🚀 快速開始

安裝 Docker

curl -fsSL https://get.docker.com | bash -s docker

運行服務器

docker run -d --name maigret -e MAIGRET_REPORTS_DIR=/path/to/reports -v /path/to/host/reports:/app/reports maigret/mcp-server:latest

✨ 主要特性

• 用戶名搜索：分析指定 URL 下的用戶信息。
• URL 分析：提取並報告指定 URL 的詳細信息。
• 多格式輸出：支持多種輸出格式，便於不同需求的使用。

📦 安裝指南

示例配置文件（config.json）

{
  "servers": [
    {
      "name": "maigret-server",
      "host": "localhost",
      "port": 8090,
      "username": "admin",
      "password": "password123"
    }
  ],
  "reports_dir": "/path/to/reports",
  "log_level": "info"
}

💻 使用示例

基礎用法

查詢用戶信息

curl -X POST http://localhost:8090/api/search \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/profile","format":"pdf"}'

分析指定 URL

curl -X POST http://localhost:8090/api/analyze \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","format":"json"}'

📚 詳細文檔

故障排除

Docker 問題

1. 驗證 Docker 是否安裝並運行：

docker --version
docker ps

2. 檢查 Docker 權限：
   • 確保用戶有權限執行 Docker 命令。
   • 在 Linux 上，將用戶添加到 docker 組：sudo usermod -aG docker $USER

報告目錄問題

1. 驗證報告目錄：
   • 確保 MAIGRET_REPORTS_DIR 變量指向的目錄存在。
   • 用戶必須有寫入權限。
   • 檢查權限：ls -la /path/to/reports/directory

貢獻指南

1. 提交問題：在 GitHub 倉庫中提出 issue。
2. 參與開發：

git clone https://github.com/yourusername/maigret-mcp-server.git
cd maigret-mcp-server
git checkout -b feature/new-feature

3. 提交代碼：

git add .
git commit -m '添加新功能'
git push origin feature/new-feature

4. 提交拉取請求：在 GitHub 上創建 Pull Request。

📄 許可證

本項目遵循 MIT 許可證，具體內容請參閱 LICENSE 文件。