Maigret MCP Server 使用说明

项目简介

Maigret MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它集成了强大的开源情报 (OSINT) 工具 Maigret。该服务器旨在为大型语言模型 (LLM) 客户端（如 Claude Desktop）提供上下文信息和功能，主要用于执行用户名跨平台搜索和URL信息分析任务。通过此服务器，用户可以方便地利用 Maigret 的功能，在各种在线平台和社交网络上进行信息搜集。

主要功能点

用户名搜索: 在数百个社交网络和网站上搜索特定用户名是否存在，帮助用户快速了解目标用户在不同平台上的注册情况。
URL分析: 解析URL链接，提取相关信息，并尝试查找与该URL关联的用户名，用于追踪在线身份和活动。
多种输出格式: 支持将搜索结果导出为 txt, html, pdf, json, csv, xmind 等多种格式，方便用户进行数据分析和报告生成。
站点过滤: 允许用户根据标签（如 photo, dating, us）过滤搜索站点，以缩小搜索范围，提高效率。
Docker 容器化: 服务器以 Docker 容器方式运行 Maigret，确保环境一致性，简化部署过程。

安装步骤

安装 Docker:
- 访问 Docker 官网下载并安装 Docker Desktop (macOS 或 Windows)。
- Linux 系统请参考 Docker Engine 安装指南进行安装。
安装 Maigret MCP Server: 打开终端，运行以下命令全局安装 'mcp-maigret' 包：
```
npm install -g mcp-maigret
```
创建报告目录: 创建一个目录用于存放 Maigret 生成的报告文件。例如，在用户home目录下创建 'maigret-reports' 目录：
```
mkdir -p ~/maigret-reports
```
配置 MCP 客户端: 以 Claude Desktop 为例，编辑其配置文件 'claude_desktop_config.json'，添加 'maigret' 服务器配置。

配置文件位置：
- macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%\Claude\claude_desktop_config.json'
配置内容 (JSON 格式):
```
{
  "mcpServers": {
    "maigret": {
      "command": "mcp-maigret",
      "env": {
        "MAIGRET_REPORTS_DIR": "/path/to/reports/directory"  // 将 "/path/to/reports/directory" 替换为实际的报告目录路径，例如 "~/maigret-reports"
      }
    }
  }
}
```
配置参数说明:
- '"maigret"': 服务器名称，在客户端中用于标识和调用该服务器。
- '"command": "mcp-maigret"': 启动 MCP 服务器的命令，这里直接使用全局安装的 'mcp-maigret' 命令。
- '"env"': 环境变量配置。
  - '"MAIGRET_REPORTS_DIR": "/path/to/reports/directory"': 必须配置。指定 Maigret 报告文件存放的目录。请将 '"/path/to/reports/directory"' 替换为您在步骤3中创建的实际目录路径，例如 '"/Users/your_username/maigret-reports"' (macOS) 或 '"C:\Users\YourUsername\maigret-reports"' (Windows)。注意使用绝对路径。
重启 MCP 客户端: 保存配置文件后，重启 Claude Desktop 等 MCP 客户端，使配置生效。

基本使用方法

配置完成后，在 MCP 客户端中，您可以使用 'maigret' 服务器提供的工具进行操作。

可用工具 (Tools):

'search_username' (用户名搜索工具)
- 功能: 根据提供的用户名，在多个社交网络和网站上进行搜索。
- 参数:
  - 'username' (必填, 字符串): 要搜索的用户名。
  - 'format' (可选, 字符串, 默认: '"pdf"'): 报告输出格式，可选值包括 '"txt"', '"html"', '"pdf"', '"json"', '"csv"', '"xmind"'。
  - 'use_all_sites' (可选, 布尔值, 默认: 'false'): 是否搜索所有可用站点（默认为搜索 Top 500 站点）。
  - 'tags' (可选, 字符串数组): 用于过滤站点的标签数组，例如 '["photo", "dating"]'。
- 示例参数 JSON:
```
{
  "username": "target_username",
  "format": "html",
  "use_all_sites": false,
  "tags": ["photo", "dating"]
}
```
'parse_url' (URL分析工具)
- 功能: 解析给定的URL，提取信息并尝试查找关联的用户名。
- 参数:
  - 'url' (必填, 字符串): 要分析的URL。
  - 'format' (可选, 字符串, 默认: '"pdf"'): 报告输出格式，可选值同 'search_username'。
- 示例参数 JSON:
```
{
  "url": "https://example.com/profile",
  "format": "txt"
}
```

使用步骤:

在 MCP 客户端中，选择或创建一个会话，并确保已连接到 'maigret' MCP 服务器。
调用 'maigret' 服务器提供的工具，例如 'search_username' 或 'parse_url'。
根据工具的要求，填写相应的参数（例如用户名或URL），并发送请求。
服务器将执行 Maigret 工具，并将结果以文本形式返回给客户端。报告文件也会保存在您配置的报告目录中。

注意: 请负责任地使用此工具，遵守相关法律法规和平台服务条款，仅用于合法的开源情报研究目的。

关键词

Maigret MCP Server 使用说明

项目简介

主要功能点

安装步骤

基本使用方法

信息