Maigret MCP Server

快速入门 · 工具 · 格式 · 安全性 · 故障排除 · 文档

mcp-maigret 是一个 MCP 服务，可让 AI Agent 运行 maigret，这是一款 OSINT 工具，可在数千个网站上检查用户名。你可以让 Agent 查找某个用户名注册了哪些网站，或分析一个个人资料 URL，然后获取保存好的报告。Maigret 在 Docker 中运行，因此除了 Docker 和 Node，无需安装其他内容。

警告

请仅将此工具用于合法且经授权的 OSINT 研究，并仅限于公开信息。请遵守法律和各网站的服务条款，尊重他人隐私。部分网站会限制访问频率或屏蔽自动查询。

亮点

• 用户名搜索：可搜索数百至数千个网站，并按标签筛选（photo、dating、us 等）。
• URL 分析。 输入个人资料 URL，maigret 会提取可获取的信息，并查找关联的用户名。
• 六种报告格式（txt、html、csv、json、xmind、pdf），保存到你选择的目录中。请参阅当前可用的格式。
• 强化输入安全。 严格验证，并使用带参数数组的 execFile。完全不涉及 shell。请参阅安全性。
• 基于 Docker。 首次使用时会拉取 maigret 镜像，因此每台机器运行的都是相同版本的 maigret。

工作原理

flowchart LR
    A["AI agent<br/>(Claude Desktop, Claude Code, any MCP client)"] -->|"MCP over stdio"| S["mcp-maigret"]
    S -->|"validate input,<br/>execFile docker run"| D["soxoj/maigret<br/>(Docker)"]
    D -->|"checks sites"| W(("Public<br/>websites"))
    D -->|"writes report"| R[("MAIGRET_REPORTS_DIR")]
    S -->|"report path + scan output"| A

快速入门

**要求：**Node.js 18 或更高版本，并已安装且运行 Docker。本项目在 macOS 上开发和测试。Linux 和 Windows（Docker Desktop）应该也能运行，但未经测试。

**1. 选择报告目录。**服务会将报告保存在此处。如果目录不存在，则会自动创建。此变量为必填项。

export MAIGRET_REPORTS_DIR="$HOME/maigret-reports"

2. 将服务添加到客户端。

claude mcp add maigret -e MAIGRET_REPORTS_DIR="$HOME/maigret-reports" -- npx -y mcp-maigret

{
  "mcpServers": {
    "maigret": {
      "command": "npx",
      "args": ["-y", "mcp-maigret"],
      "env": { "MAIGRET_REPORTS_DIR": "/absolute/path/to/maigret-reports" }
    }
  }
}

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

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

**3. 试用。**让 Agent 执行：“使用 maigret 检查用户名 octocat 注册了哪些网站，并按 coding 标签筛选。”

首次搜索时会拉取 maigret 镜像（约 800 MB），因此需要更长时间。

工具

search_username

跨社交网络和网站搜索用户名。

{ "username": "octocat", "format": "html", "tags": ["coding"] }

结果包含已保存报告的路径和 maigret 的控制台输出。如果未生成报告文件，结果会说明这一点，而不会报告成功。

parse_url

解析 URL，提取信息并搜索相关用户名。

{ "url": "https://github.com/octocat" }

结果将以 maigret 扫描输出文本的形式返回。

输出格式

报告写入 MAIGRET_REPORTS_DIR。Maigret 会选择文件名，并在某些格式的文件名中添加后缀。Maigret 找到相关用户名时，也可以在主报告旁写入额外报告（例如 report_octocatsup.txt）。

这些状态是根据 maigret 0.6.6（镜像 soxoj/maigret:latest，2026 年 10 月）检查的。Maigret 的命令行会随版本变化，因此这些状态可能会有所不同。

安全

用户名、URL 和标签来自 AI Agent，均视为不可信输入。

• 验证。 用户名只允许使用 [A-Za-z0-9_.-]（最多 100 个字符）。标签只允许使用 [A-Za-z0-9_-]（最多 50 个字符）。URL 必须能解析为 http 或 https，且不得包含 shell 元字符。
• 不使用 shell。 Docker 使用 execFile 和参数数组启动，绝不会拼接命令字符串。
• 写入范围受限。 报告由容器写入你挂载的单个目录。服务不会在其他位置读取或写入文件。

以下情况不在此保障范围内：服务会代表你的 Agent 在本机运行 Docker，并从你的 IP 地址向许多第三方网站发起网络请求。仅对你信任的 Agent 和客户端运行此服务。

发现漏洞？请私下报告。参见 SECURITY.md。

故障排除

更多内容请参阅文档。

贡献

欢迎贡献。请从 CONTRIBUTING.md 开始。

• 更新日志
• 问题与帮助：支持
• 安全报告：SECURITY.md（通过私密公告提交，切勿发布为公开议题）

许可证

MIT。这是独立项目，与 maigret 项目没有关联。Maigret 由 soxoj 开发，并拥有自己的许可证。