Maigret OSINT MCP server

This MCP server for Maigret provides tools for searching usernames across social networks and analyzing URLs through a standardized protocol interface. The server enables OSINT (Open Source Intelligence) capabilities within compatible applications like Claude Desktop.

Installation Options

Quick Install via Smithery

The fastest way to install:

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

Manual Installation

1. Prerequisites:

   • Node.js v18 or later
   • Docker installed and running
   • Write access to create a reports directory

2. Install globally via npm:

   npm install -g mcp-maigret
   

3. Create a reports directory:

   mkdir -p /path/to/reports/directory
   

4. Configure Claude Desktop:

   Add this to your Claude Desktop configuration file:

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

   Configuration file location:

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

5. Restart Claude Desktop

Source Code Installation

For those who want to run from source:

1. Clone and build:

   git clone <repository_url>
   cd mcp-maigret
   npm install
   npm run build
   

2. Configure Claude Desktop for source installation:

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

Usage

Username Search Tool

Search for usernames across numerous social networks and websites:

• Tool name: search_username
• Parameters:
  • username (required): Username to search for
  • format (optional, default: "pdf"): Output format (txt, html, pdf, json, csv, xmind)
  • use_all_sites (optional, default: false): Use all available sites instead of top 500
  • tags (optional): Array of tags to filter sites (e.g., ["photo", "dating"])

Example usage:

{
  "username": "test_user123",
  "format": "html",
  "use_all_sites": false,
  "tags": ["photo"]
}

URL Analysis Tool

Parse URLs to extract information and search for associated usernames:

• Tool name: parse_url
• Parameters:
  • url (required): URL to analyze
  • format (optional, default: "pdf"): Output format (txt, html, pdf, json, csv, xmind)

Example usage:

{
  "url": "https://example.com/profile",
  "format": "txt"
}

Troubleshooting

Docker Issues

1. Verify Docker installation:

   docker --version
   docker ps
   

2. Check Docker permissions:

   • On Linux, add your user to the docker group: sudo usermod -aG docker $USER

Report Directory Issues

1. Verify directory setup:

   • Ensure the directory specified in MAIGRET_REPORTS_DIR exists
   • Check permissions: ls -la /path/to/reports/directory
   • Your user must have write permissions

2. Common configuration issues:

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

3. After fixing issues:

   • Save the configuration file
   • Restart Claude Desktop

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
• "Error creating reports directory": Check directory permissions and path
• "Error executing maigret": Check Docker logs for details

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "maigret" '{"command":"mcp-maigret","env":{"MAIGRET_REPORTS_DIR":"/path/to/reports/directory"}}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

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

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

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

2. Add this to your configuration file:

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

3. Restart Claude Desktop for the changes to take effect