Frequently Asked Questions about Maigret MCP Server

Q: What is Maigret? A: Maigret is a powerful OSINT (Open Source Intelligence) tool used for collecting user account information from various public sources. It helps in finding usernames across different social networks and websites.

Q: What is an MCP Server? A: MCP stands for Model Context Protocol. An MCP server acts as a bridge, allowing AI models and agents to access and interact with external data sources and tools like Maigret.

Q: What are the key features of the Maigret MCP Server? A: Key features include username search across hundreds of sites, URL analysis, multiple output formats (txt, html, pdf, json, csv, xmind), site filtering by tags, and Docker-based deployment for consistent execution.

Q: What are the requirements for running the Maigret MCP Server? A: You need Node.js (v18 or later), Docker, and a compatible operating system (macOS, Linux, or Windows with Docker Desktop installed). Write access to a reports directory is also required.

Q: How do I install the Maigret MCP Server? A: You can install it via Smithery using the command npx -y @smithery/cli install mcp-maigret --client claude, or manually by installing Docker, installing the server globally via npm (npm install -g mcp-maigret), creating a reports directory, and adding the server configuration to your Claude Desktop configuration file.

Q: What is UBOS and how does it relate to the Maigret MCP Server? A: UBOS is a full-stack AI Agent Development Platform focused on bringing AI Agents to every business department. The Maigret MCP Server is available on the UBOS Asset Marketplace, allowing UBOS users to easily integrate OSINT capabilities into their AI Agents.

Q: What is the purpose of the reports directory? A: The reports directory is where Maigret stores the output files generated from username searches and URL analysis. The server needs write access to this directory.

Q: How do I troubleshoot Docker issues? A: Verify that Docker is installed and running using docker --version and docker ps. Also, check that your user has the necessary permissions to run Docker commands.

Q: What do I do if I get an error message saying ‘MAIGRET_REPORTS_DIR environment variable must be set’? A: This means you need to add the MAIGRET_REPORTS_DIR environment variable to your configuration file, specifying the path to your reports directory.

Q: Is the Maigret MCP Server safe to use? A: The tool is designed for legitimate OSINT research purposes. Users should only search for publicly available information, respect privacy and data protection laws, follow the terms of service of the platforms being searched, and use the tool responsibly and ethically. Be aware that some sites may rate-limit or block automated searches.

Q: What output formats are supported by the Maigret MCP Server? A: The server supports txt, html, pdf, json, csv, and xmind output formats.

Q: How can I filter searches by site tags? A: When using the search_username tool, you can provide an array of tags (e.g., ["photo", "dating"]) to filter the sites that are searched.

Q: How can I contribute to the Maigret MCP Server project? A: You can fork the repository, create a feature branch, commit your changes, push to the branch, and open a Pull Request.