Maigret MCP Server

A Model Context Protocol (MCP) server for maigret, a powerful OSINT tool that collects user account information from various public sources. This server provides tools for searching usernames across social networks and analyzing URLs. It is designed to integrate seamlessly with MCP-compatible applications like Claude Desktop.

⚠️ Warning

This tool is designed for legitimate OSINT research purposes. Please:

• Only search for information that is publicly available
• Respect privacy and data protection laws
• Follow the terms of service of the platforms being searched
• Use responsibly and ethically
• Be aware that some sites may rate-limit or block automated searches

Security

This server implements several security measures to prevent command injection attacks:

Input Validation

• Usernames: Only alphanumeric characters, underscores, hyphens, and periods are allowed (max 100 characters)
• URLs: Must be valid HTTP/HTTPS URLs without shell metacharacters
• Tags: Only alphanumeric characters, underscores, and hyphens are allowed

Safe Command Execution

• Uses execFile() instead of exec() to prevent shell interpolation
• All command arguments are passed as arrays, not concatenated strings
• Docker commands are executed without shell interpretation

Reporting Security Issues

If you discover a security vulnerability, please report it by opening an issue or contacting the maintainers directly. We take security seriously and will respond promptly.

Requirements

• Node.js (v18 or later)
• Docker
• macOS, Linux, or Windows with Docker Desktop installed
• Write access to the reports directory

Quick Start

Installing via Smithery

To install Maigret for Claude Desktop automatically via Smithery:

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

Installing Manually

1. Install Docker:

   • macOS: Install Docker Desktop
   • Linux: Follow the Docker Engine installation guide

2. Install the server globally via npm:

npm install -g mcp-maigret

3. Create a reports directory:

mkdir -p /path/to/reports/directory

4. Add to your Claude Desktop configuration file:

{
  "mcpServers": {
    "maigret": {
      "command": "mcp-maigret",
      "env": {
        "MAIGRET_REPORTS_DIR": "/path/to/reports/directory"
      }
    }
  }
}

Configuration file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

5. Restart Claude Desktop

Alternative Setup (From Source)

If you prefer to run from source or need to modify the code:

1. Clone and build:

git clone <repository_url>
cd mcp-maigret
npm install
npm run build

2. Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "maigret": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-maigret/build/index.js"],
      "env": {
        "MAIGRET_REPORTS_DIR": "/path/to/reports/directory"
      }
    }
  }
}

Features

• Username Search: Search for a username across hundreds of social networks and websites
• URL Analysis: Parse URLs to extract information and search for associated usernames
• Multiple Output Formats: Support for txt, html, pdf, json, csv, and xmind formats
• Site Filtering: Filter searches by site tags (e.g., photo, dating, us)
• Docker-based: Reliable and consistent execution across environments

Tools

1. Username Search Tool

• Name: `search_usernam

... View full README on GitHub