Maigret OSINT

🚀 Maigret MCP Server

This is an MCP server compatible with the maigret tool, supporting the following features: username search, URL analysis, and multiple output formats (including text, HTML, PDF, JSON, and CSV).

🚀 Quick Start

Install Docker

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

Run the Server

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

✨ Features

• Username Search: Analyze user information under the specified URL.
• URL Analysis: Extract and report detailed information of the specified URL.
• Multi-format Output: Support multiple output formats for different usage requirements.

📚 Documentation

Example Configuration File (config.json)

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

💻 Usage Examples

Query User Information

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

Analyze a Specified URL

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

🔧 Troubleshooting

Docker Issues

1. Verify if Docker is installed and running:

   docker --version
   docker ps
   

2. Check Docker permissions:
   • Ensure the user has permission to execute Docker commands.
   • On Linux, add the user to the docker group: sudo usermod -aG docker $USER

Report Directory Issues

1. Verify the report directory:
   • Ensure the directory pointed to by the MAIGRET_REPORTS_DIR variable exists.
   • The user must have write permissions.
   • Check permissions: ls -la /path/to/reports/directory

🤝 Contribution Guide

1. Submit an Issue: Create an issue in the GitHub repository.
2. Participate in Development:

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

3. Submit Code:

   git add .
   git commit -m 'Add new feature'
   git push origin feature/new-feature
   

4. Submit a Pull Request: Create a Pull Request on GitHub.

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for details.