mcp-maigret
Author: BurtTheCoder
Description: MCP (Model Context Protocol) server that wraps the Maigret OSINT username-search/URL-analysis tool so it can be invoked from MCP-compatible clients such as Claude Desktop.
Stars: 172
Forks: 22
License: MIT License
Category: Specialized
Overview
Installation
1. Prerequisites
• Node.js ≥ 18
• Python 3.8+ with Maigret installed globally (pip install maigret)
2. Clone and install
git clone https://github.com/BurtTheCoder/mcp-maigret.git
cd mcp-maigret
npm install # installs JS dependencies3. Configuration (environment variables)
• PORT – TCP port the MCP server should listen on (default 3000)
• MAIGRET_BIN – Full path to the Maigret executable if it is not in $PATH
• MCP_TOKEN – (optional) bearer token required by clients, if you enable auth in config.json
Example:
export PORT=8080
export MCP_TOKEN=super-secret
npm start4. Run the server
npm start # starts the MCP HTTP server5. Verify
curl -X POST http://localhost:8080/search -H "Authorization: Bearer super-secret" -d '{"username":"example"}' The server should return a JSON array with sites where the username was found.
01
search_username
Search for a username across social networks and sites
02
parse_url
Parse a URL to extract information and search for associated usernames
License: MIT License
Updated 7/30/2025