Maigret OSINT Tool MCP Server

Overview

Maigret MCP Server provides a powerful OSINT (Open Source Intelligence) capability directly within your AI assistant. It allows you to search for usernames across hundreds of social networks and websites, as well as analyze URLs to extract information about associated accounts.

Important Warning

This tool is designed for legitimate OSINT research purposes only. Please:

• 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

Before installing the Maigret MCP Server, ensure you have:

• Node.js (v18 or later)
• Docker installed and running
• Write access to a directory for storing reports

Installation Options

Option 1: Install via Smithery (Recommended)

The easiest way to install Maigret for Claude Desktop is via Smithery:

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

Option 2: Manual Installation

1. Install the server globally via npm:

npm install -g mcp-maigret

2. Create a directory to store reports:

mkdir -p /path/to/reports/directory

3. Add the server configuration to your AI assistant's configuration file.

For Claude Desktop, edit the configuration file located at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following configuration:

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

4. Restart your AI assistant application to apply the changes.

Option 3: Running from Source

If you prefer to run from source or need to modify the code:

1. Clone the repository and build:

git clone https://github.com/BurtTheCoder/mcp-maigret
cd mcp-maigret
npm install
npm run build

2. Configure your AI assistant to use the local build:

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

Troubleshooting

Docker Issues

1. Verify Docker is installed and running:

docker --version
docker ps

2. Check Docker permissions:
   • Ensure your user has permissions to run Docker commands
   • On Linux, add your user to the docker group: sudo usermod -aG docker $USER

Reports Directory Issues

1. Verify the reports directory:

   • The directory specified in MAIGRET_REPORTS_DIR must exist
   • Your user must have write permissions to this directory
   • Check permissions: ls -la /path/to/reports/directory

2. Common configuration mistakes:

   • Missing MAIGRET_REPORTS_DIR environment variable
   • Directory doesn't exist
   • Incorrect permissions
   • Trailing slashes in the path

3. After fixing any issues:

   • Save the configuration file
   • Restart your AI assistant application

Common 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