Maigret

MCP server for maigret, a powerful OSINT tool that collects user account information from various public sources.

javascript

229

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

Maigret MCP Server enables you to run a Model Context Protocol (MCP) interface for Maigret, a powerful OSINT tool. It lets you search usernames across numerous public sources and analyze URLs, and it is designed to work with MCP clients and Claude Desktop for seamless integration.

How to use

You connect an MCP-compatible client to Maigret MCP Server to perform username searches and URL analyses. Use the server to initiate a search for a username across supported sites, or to analyze a URL and retrieve related user identifiers and extracted data. Output can be generated in multiple formats to fit your workflow, and you can filter searches by site tags to narrow results.

How to install

Prerequisites you need before starting:

Install Node.js (version 18 or later) and Docker on your system.

Choose one of the installation paths below and follow the steps.

Additional setup steps

Final steps after installation include configuring Claude Desktop to use Maigret MCP Server and ensuring a reports directory is writable by your user.

Notes on security and usage

The server enforces input validation for usernames, URLs, and tags to prevent injection and misuse. Always use public data in compliance with privacy laws and platform terms of service, and be aware that some sites may rate-limit automated searches.

Troubleshooting

If you encounter issues, verify prerequisites, ensure the reports directory exists and is writable, and check Docker permissions. Restart each application component after changes.

Security and compliance

The server uses safe command execution patterns and input validation. Report security issues by contacting the maintainers or opening an issue.

Available tools

search_username

Search for a username across social networks and sites with filters for format and tags.

parse_url

Parse a URL to extract information and search for associated usernames.