Maigret MCP Server

How to use

Set up Maigret MCP Server in your MCP client (for example Claude Desktop) to run username searches and URL analyses. You specify the MCP server and the directory where generated reports will be saved. You can then issue searches for a username across many sites or analyze a URL to discover related usernames and signals across platforms.

Operational flow: - Install and run the server using your preferred method. - Point your client to the Maigret MCP Server as configured, and provide a username or a URL for analysis. - Retrieve results in formats like txt, html, pdf, json, csv, or xmind, depending on the tool request. - The server uses a dedicated reports directory to store output files for later review.

Key features you can use from the client include: - Username Search: look up a username across hundreds of social networks and sites. - URL Analysis: parse a URL to extract information and search for associated usernames. - Output formats: txt, html, pdf, json, csv, xmind. - Site filtering: refine searches by site tags such as photo or dating.

How to install

Prerequisites you need before installation: - Node.js version 18 or later - Docker (optional, for containerized runs) - A writable reports directory that the server can use to store outputs

Option A: Install via Smithery (recommended for Claude Desktop users)
- Run the following command to install Maigret for Claude Desktop automatically:
```bash
npx -y @smithery/cli install mcp-maigret --client claude
```
- After installation, configure Claude Desktop to use the Maigret MCP Server (see the configuration snippet in the next step). Restart Claude Desktop to apply settings.

Option B: Manual installation with npm (local runtime)
- Install Docker if you plan to run in a container or prefer Docker-based execution.
- Install the server globally via npm:
```bash
npm install -g mcp-maigret
```
- Create a directory for reports where outputs will be written:
```bash
mkdir -p /path/to/reports/directory
```
- Add the server to your Claude Desktop configuration with the environment variable MAIGRET_REPORTS_DIR set to your reports path:
```json
{
  "mcpServers": {
    "maigret": {
      "command": "mcp-maigret",
      "env": {
        "MAIGRET_REPORTS_DIR": "/path/to/reports/directory"
      }
    }
  }
}
```
- Restart Claude Desktop after saving the configuration.

Option C: Install from source (if you prefer to modify the code)
- Clone the repository, install dependencies, and build:
```bash
git clone <repository_url>
cd mcp-maigret
npm install
npm run build
```
- Add to Claude Desktop configuration using the built index file:
```json
{
  "mcpServers": {
    "maigret": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-maigret/build/index.js"],
      "env": {
        "MAIGRET_REPORTS_DIR": "/path/to/reports/directory"
      }
    }
  }
}
```
- Restart Claude Desktop after saving the configuration.

Additional configuration and notes

Configuration details: - The server writes all outputs to the MAIGRET_REPORTS_DIR you provide via environment variable MAIGRET_REPORTS_DIR. Ensure the path exists and your user has write permissions.

Security and ethics: - Use only publicly available information. - Respect privacy, data protection laws, and the terms of service of each platform. - Be mindful of rate limits and avoid abusive automation.

Troubleshooting quick checks: - Confirm Docker is running if you rely on Docker-based execution. - Verify MAIGRET_REPORTS_DIR is set and writable. - Ensure the server process is running and reachable from your MCP client.

Notes on outputs and formats: - You can request output in txt, html, pdf, json, csv, or xmind formats depending on the tool usage. - Site filtering allows refining which sources are searched by including tags like photo or dating.

Troubleshooting

Docker issues - Verify Docker is installed and running: ``bash docker --version docker ps ` - Check user permissions for Docker, and on Linux add your user to the docker group if needed: `bash sudo usermod -aG docker $USER ` Reports directory issues - The MAIGRET_REPORTS_DIR must exist and be writable by your user. - Permissions can be checked with: `bash ls -la /path/to/reports/directory `` - Common mistakes include missing environment variable, non-existent directory, or incorrect permissions.

search_username

Search for a username across social networks and sites with configurable output formats and site filters

parse_url

Parse a URL to extract information and search for associated usernames across sources