Maigret MCP Server

基本能力

产品定位

Maigret MCP Server 是一个用于 OSINT（开源情报）研究的工具，专注于从公开来源收集和分析用户账户信息。

核心功能

• 用户名搜索：在数百个社交网络和网站上搜索用户名。
• URL 分析：解析 URL 以提取信息并搜索关联的用户名。
• 多种输出格式：支持 txt、html、pdf、json、csv 和 xmind 格式。
• 站点过滤：通过标签（如 photo、dating、us）过滤搜索。
• 基于 Docker：在不同环境中提供可靠且一致的执行。

适用场景

• OSINT 研究
• 社交媒体分析
• 用户账户信息收集
• URL 信息提取

工具列表

1. Username Search Tool
2. 名称: search_username
3. 描述: 在社交网络和网站上搜索用户名

4. 参数:

   • username (必填): 要搜索的用户名
   • format (可选, 默认: "pdf"): 输出格式 (txt, html, pdf, json, csv, xmind)
   • use_all_sites (可选, 默认: false): 使用所有可用站点而不是前 500 个
   • tags (可选): 用于过滤站点的标签数组 (如 ["photo", "dating"])

5. URL Analysis Tool

6. 名称: parse_url
7. 描述: 解析 URL 以提取信息并搜索关联的用户名
8. 参数:
   • url (必填): 要分析的 URL
   • format (可选, 默认: "pdf"): 输出格式 (txt, html, pdf, json, csv, xmind)

常见问题解答

• Docker 问题
• 确保 Docker 已安装并运行
• 检查 Docker 权限
• 报告目录问题
• 确保 MAIGRET_REPORTS_DIR 环境变量已设置
• 确保目录存在且具有写权限

使用教程

使用依赖

• Node.js (v18 或更高版本)
• Docker
• macOS、Linux 或安装了 Docker Desktop 的 Windows
• 对报告目录的写权限

安装教程

通过 Smithery 安装

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

手动安装

1. 安装 Docker:
2. macOS: 安装 Docker Desktop

3. Linux: 遵循 Docker Engine 安装指南

4. 通过 npm 全局安装服务器:

npm install -g mcp-maigret

1. 创建报告目录:

mkdir -p /path/to/reports/directory

1. 添加到 Claude Desktop 配置文件:

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

1. 重启 Claude Desktop

从源代码安装

1. 克隆并构建:

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

1. 添加到 Claude Desktop 配置:

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

调试方式

1. 验证 Docker 是否安装并运行:

docker --version
docker ps

1. 检查 Docker 权限:
2. 确保用户有权限运行 Docker 命令

3. 在 Linux 上，将用户添加到 docker 组: sudo usermod -aG docker $USER

4. 验证报告目录:

5. 确保 MAIGRET_REPORTS_DIR 环境变量已设置
6. 确保目录存在且具有写权限
7. 检查权限: ls -la /path/to/reports/directory

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。