mcp-maigret

Maigret MCP Server provides an interface to run the Maigret OSINT tool through MCP-compatible clients such as Claude Desktop. It exposes tools for searching usernames across hundreds of social networks and websites, and for analyzing URLs to extract associated information and usernames. The server is designed to be secure by validating inputs and passing commands as arguments, reducing the risk of shell injection. To use it, connect your MCP client to the configured server (named maigret in Claude Desktop configuration) and invoke the built-in tools like Username Search (search_username) and URL Analysis (parse_url) with the required parameters. Results can be produced in multiple formats (txt, html, pdf, json, csv, xmind) and can be filtered by site tags to tailor the scope of the search.

Prerequisites:

• Node.js v18 or later
• npm (comes with Node.js)
• Docker (optional, for Maigret container-based workflows)
• A Claude Desktop installation if you plan to connect via Claude

Option A: Install via Smithery (recommended for Claude Desktop integration)

1. Ensure you have npm and npx installed with Node.js
2. Install Maigret for Claude Desktop automatically via Smithery:

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

Option B: Manual installation (from source)

1. Install dependencies and build from source

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

2. Add to Claude Desktop configuration (example):

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

3. Start Claude Desktop and ensure the server appears in the available MCP servers.

Option C: Run via npm package globally

1. Install globally

npm install -g mcp-maigret

2. Run the server (adjust path as needed):

maigret --reports /path/to/reports

Notes:

• If you run from source, point Claude Desktop to the built index.js as shown above.
• The MAIGRET_REPORTS_DIR environment variable must be set to a writable directory where reports are saved.

• MAIGRET_REPORTS_DIR is required to store generated reports. Ensure the path exists and is writable by the user running the server.
• Input validation enforces that usernames contain only alphanumeric characters, underscores, hyphens, and periods, and that URLs are valid HTTP/HTTPS URLs without shell metacharacters.
• When running Docker-based workflows, ensure Docker is installed and the current user has permission to run Docker commands.
• If you encounter issues, check the server logs for validation errors or for failures in report generation, and verify that the configuration in Claude Desktop points to the correct command and environment variables.
• The server supports multiple output formats (txt, html, pdf, json, csv, xmind). Use the optional format parameter in the search tool to select the desired output.