Maigret MCP Server

Warning

• 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

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

Installing Manually

1. Install Docker:

2. Install the server globally via npm:

1. Create a reports directory:

1. Add to your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

1. Restart Claude Desktop

Alternative Setup (From Source)

1. Clone and build:

1. Add to your Claude Desktop configuration:

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_username

• Description: Search for a username across social networks and sites

• Parameters:

2. URL Analysis Tool

• Name: parse_url

• Description: Parse a URL to extract information and search for associated usernames

• Parameters:

Troubleshooting

Docker Issues

1. Verify Docker is installed and running:

1. Check Docker permissions:

Reports Directory Issues

1. Verify the reports directory:

2. Common configuration mistakes:

3. After fixing any issues:

Error Messages

• "Docker is not installed or not running": Install Docker and start the Docker daemon

• "MAIGRET_REPORTS_DIR environment variable must be set": Add the environment variable to your configuration

• "Error creating reports directory": Check directory permissions and path

• "Error executing maigret": Check Docker logs and ensure the container has proper permissions

Contributing

1. Fork the repository

2. Create a feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

License

Maigret MCP Server

Warning

• 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

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

Installing Manually

1. Install Docker:

2. Install the server globally via npm:

1. Create a reports directory:

1. Add to your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

1. Restart Claude Desktop

Alternative Setup (From Source)

1. Clone and build:

1. Add to your Claude Desktop configuration:

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_username

• Description: Search for a username across social networks and sites

• Parameters:

2. URL Analysis Tool

• Name: parse_url

• Description: Parse a URL to extract information and search for associated usernames

• Parameters:

Troubleshooting

Docker Issues

1. Verify Docker is installed and running:

1. Check Docker permissions:

Reports Directory Issues

1. Verify the reports directory:

2. Common configuration mistakes:

3. After fixing any issues:

Error Messages

• "Docker is not installed or not running": Install Docker and start the Docker daemon

• "MAIGRET_REPORTS_DIR environment variable must be set": Add the environment variable to your configuration

• "Error creating reports directory": Check directory permissions and path

• "Error executing maigret": Check Docker logs and ensure the container has proper permissions

Contributing

1. Fork the repository

2. Create a feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

License