Maigret MCP Server

Maigret MCP Server

OSINT username and URL search server for the Model Context Protocol.

View on GitHub
205
Stars
29
Forks
205
Watchers
5
Issues
Maigret MCP Server provides Model Context Protocol (MCP) integration for the Maigret OSINT tool, enabling AI and context-aware applications to search for usernames across hundreds of social networks and analyze URLs. Designed for seamless operation with MCP-compatible clients like Claude Desktop, it supports multiple output formats and advanced filtering options. The server can be installed via Docker or npm, offers Docker-based deployment for consistent performance, and facilitates responsible OSINT research.

Key Features

Searches usernames across hundreds of social networks and websites
Parses URLs to extract and analyze user information
Provides multiple output formats: txt, html, pdf, json, csv, xmind
Filters searches by site tags such as photo, dating, or regional tags
Available as a Docker-based server for reliable deployment
Seamless integration with MCP-compatible applications like Claude Desktop
Supports environment variable configuration for reports directory
Offers installation via Smithery or manual setup
Ethical use warning and compliance guidelines included
Open source and modifiable to customize workflows

Use Cases

Automated OSINT username checks for investigators
Analyzing publicly available social network profiles
Integrating with AI tools to provide real-time context-aware searches
Generating detailed reports in various formats for investigations
Filtering search targets based on specific site types or tags
Academic or research-driven data collection on user presence online
Organizations monitoring brand or executive exposure on social networks
Security teams tracking possible impersonation accounts online
Forensics and digital evidence gathering
Supporting law enforcement with legitimate, documented online presence checks

README

Maigret MCP Server

smithery badge

A Model Context Protocol (MCP) server for maigret, a powerful OSINT tool that collects user account information from various public sources. This server provides tools for searching usernames across social networks and analyzing URLs. It is designed to integrate seamlessly with MCP-compatible applications like Claude Desktop.

⚠️ Warning

This tool is designed for legitimate OSINT research purposes. 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

  • 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

To install Maigret for Claude Desktop automatically via Smithery:

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

Installing Manually

  1. Install Docker:

  2. Install the server globally via npm:

bash
npm install -g mcp-maigret
  1. Create a reports directory:
bash
mkdir -p /path/to/reports/directory
  1. Add to your Claude Desktop configuration file:
json
{
  "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
  1. Restart Claude Desktop

Alternative Setup (From Source)

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

  1. Clone and build:
bash
git clone <repository_url>
cd mcp-maigret
npm install
npm run build
  1. Add to your Claude Desktop configuration:
json
{
  "mcpServers": {
    "maigret": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-maigret/build/index.js"],
      "env": {
        "MAIGRET_REPORTS_DIR": "/path/to/reports/directory"
      }
    }
  }
}

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:
    • 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:

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

2. URL Analysis Tool

  • Name: parse_url
  • Description: Parse a URL to extract information and search for associated usernames
  • Parameters:
    • url (required): URL to analyze
    • format (optional, default: "pdf"): Output format (txt, html, pdf, json, csv, xmind)

Example:

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

Troubleshooting

Docker Issues

  1. Verify Docker is installed and running:
bash
docker --version
docker ps
  1. 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 Claude Desktop

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

This project is licensed under the MIT License - see the LICENSE file for details.

Star History

Star History Chart

Repository Owner

BurtTheCoder

Repository Details

Language JavaScript
Default Branch main
Size 68 KB
Contributors 5
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

JavaScript
89.28%
Dockerfile
10.72%

Tags

docker

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Semgrep MCP Server

    Semgrep MCP Server

    A Model Context Protocol server powered by Semgrep for seamless code analysis integration.

    Semgrep MCP Server implements the Model Context Protocol (MCP) to enable efficient and standardized communication for code analysis tasks. It facilitates integration with platforms like LM Studio, Cursor, and Visual Studio Code, providing both Docker and Python (PyPI) deployment options. The tool is now maintained in the main Semgrep repository with continued updates, enhancing compatibility and support across developer tools.

    • ⭐ 611
    • MCP
    • semgrep/mcp
  • ORKL MCP Server

    ORKL MCP Server

    A Model Context Protocol server for threat intelligence queries via the ORKL API.

    ORKL MCP Server is an implementation of the Model Context Protocol (MCP) designed for seamless integration with MCP-compatible applications. It enables secure querying of the ORKL API, offering tools to fetch and analyze threat reports, threat actors, and intelligence sources. The server streamlines access to detailed cyber threat data for security operations and research.

    • ⭐ 45
    • MCP
    • fr0gger/MCP_Security
  • mcp-recon

    mcp-recon

    Conversational reconnaissance interface and MCP server for HTTP and ASN analysis.

    mcp-recon acts as a conversational interface and Model Context Protocol (MCP) server, enabling seamless web domain and ASN reconnaissance through natural language prompts. It integrates powerful tooling like httpx and asnmap to conduct lightweight or full HTTP analysis and ASN lookups, exposing these capabilities to any MCP-compatible AI assistant. With predefined prompts and Docker-based deployment, it streamlines infrastructure analysis via AI interfaces such as Claude Desktop.

    • ⭐ 22
    • MCP
    • nickpending/mcp-recon
  • VirusTotal MCP Server

    VirusTotal MCP Server

    Security analysis server for VirusTotal with comprehensive relationship data, compatible with MCP-enabled applications.

    VirusTotal MCP Server is a Model Context Protocol server that interfaces with the VirusTotal API to deliver detailed security analysis of URLs, files, IPs, and domains. It provides comprehensive reports with automatically fetched relationship data, supporting rich security insights in a single request. Designed for seamless integration with MCP-compatible clients like Claude Desktop, it supports easy installation and flexible configuration options.

    • ⭐ 88
    • MCP
    • BurtTheCoder/mcp-virustotal
  • Campertunity MCP Server

    Campertunity MCP Server

    Model Context Protocol server for AI-driven camping and outdoor recreation data

    Implements the Model Context Protocol (MCP) to provide AI models with structured access to camping and outdoor recreation data. Offers tools for searching, filtering, and booking campgrounds and sites based on a wide range of criteria. Enhances data accuracy with AI and aggregates information from multiple sources, enabling dynamic, real-time queries and bookings. Ideal for integrating intelligent camping experiences into AI-driven applications.

    • ⭐ 11
    • MCP
    • campertunity/mcp-server
  • RAD Security MCP Server

    RAD Security MCP Server

    AI-powered security insights for Kubernetes and cloud environments via the Model Context Protocol.

    RAD Security MCP Server is an implementation of the Model Context Protocol designed to deliver AI-powered security insights and operations for Kubernetes and cloud platforms. It serves as an MCP server for RAD Security, providing a range of toolkits for container, cluster, identity, audit, and threat management. The server is easily configurable via environment variables, allowing for flexible toolkit activation and authentication options. Multiple deployment options are supported, including Node.js, Docker, and integration with development environments like Cursor IDE and Claude Desktop.

    • ⭐ 5
    • MCP
    • rad-security/mcp-server
    • View all Alternatives

    Didn't find tool you were looking for?

    Be as detailed as possible for better results