Maigret MCP Server - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

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 安装

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

手动安装

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

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

4. 通过 npm 全局安装服务器:
   bash
npm install -g mcp-maigret

5. 创建报告目录:
   bash
mkdir -p /path/to/reports/directory

6. 添加到 Claude Desktop 配置文件:
   json
{
"mcpServers": {
"maigret": {
"command": "mcp-maigret",
"env": {
"MAIGRET_REPORTS_DIR": "/path/to/reports/directory"
}
}
}
}

7. 重启 Claude Desktop

从源代码安装

1. 克隆并构建:
   bash
git clone <repository_url>
cd mcp-maigret
npm install
npm run build

2. 添加到 Claude Desktop 配置:
   json
{
"mcpServers": {
"maigret": {
"command": "node",
"args": ["/absolute/path/to/mcp-maigret/build/index.js"],
"env": {
"MAIGRET_REPORTS_DIR": "/path/to/reports/directory"
}
}
}
}

调试方式

1. 验证 Docker 是否安装并运行:
   bash
docker --version
docker ps

2. 检查 Docker 权限:

3. 确保用户有权限运行 Docker 命令

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

5. 验证报告目录:

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