Maigret MCP 服务器

一个用于 maigret 的模型上下文协议 (MCP) 服务器，maigret 是一个强大的 OSINT 工具，可以从各种公开来源收集用户账户信息。该服务器提供了跨社交网络搜索用户名和分析 URL 的工具。它被设计为与像 Claude Desktop 这样的 MCP 兼容应用程序无缝集成。

⚠️ 警告

此工具旨在用于合法的 OSINT 研究目的。请：

• 仅搜索公开可用的信息
• 尊重隐私和数据保护法律
• 遵守所搜索平台的服务条款
• 负责任且道德地使用
• 注意某些网站可能会限制或阻止自动搜索

要求

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

快速开始

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Maigret：

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

手动安装

1. 安装 Docker：

   • macOS: 安装 Docker Desktop
   • Linux: 按照 Docker Engine 安装指南操作

2. 通过 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"
      }
    }
  }
}

配置文件位置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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"
      }
    }
  }
}

特性

• 用户名搜索：在数百个社交网络和网站上搜索用户名
• URL 分析：解析 URL 以提取信息并搜索相关联的用户名
• 多种输出格式：支持 txt, html, pdf, json, csv 和 xmind 格式
• 站点过滤：按站点标签（例如，照片、约会、美国）筛选搜索
• 基于 Docker：跨环境可靠且一致的执行

工具

1. 用户名搜索工具

• 名称: search_username
• 描述: 在社交网络和网站上搜索用户名
• 参数:
  • username (必需): 要搜索的用户名
  • format (可选，默认: "pdf"): 输出格式 (txt, html, pdf, json, csv, xmind)
  • use_all_sites (可选，默认: false): 使用所有可用站点而不是前 500 个站点
  • tags (可选): 用于筛选站点的标签数组 (例如，["photo", "dating"])

示例：

{
  "username": "test_user123",
  "format": "html",
  "use_all_sites": false,
  "tags": ["photo"]
}

2. URL 分析工具

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

示例:

{
  "url": "https://example.com/profile",
  "format": "txt"
}

故障排除

Docker 问题

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

docker --version
docker ps

1. 检查 Docker 权限：
   • 确保您的用户有权限运行 Docker 命令
   • 在 Linux 上，将您的用户添加到 docker 组：sudo usermod -aG docker $USER

报告目录问题

1. 验证报告目录：

   • MAIGRET_REPORTS_DIR 中指定的目录必须存在
   • 您的用户必须对该目录具有写权限
   • 检查权限：ls -la /path/to/reports/directory

2. 常见配置错误：

   • 缺少 MAIGRET_REPORTS_DIR 环境变量
   • 目录不存在
   • 权限不正确
   • 路径末尾有多余的斜杠

3. 修正任何问题后：

   • 保存配置文件
   • 重启 Claude Desktop

错误消息

• "Docker 未安装或未运行": 安装 Docker 并启动 Docker 守护进程
• "必须设置 MAIGRET_REPORTS_DIR 环境变量": 将环境变量添加到您的配置中
• "创建报告目录时出错": 检查目录权限和路径
• "执行 maigret 时出错": 检查 Docker 日志并确保容器具有适当的权限

贡献

1. 分叉仓库
2. 创建一个功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

许可证

此项目根据 MIT 许可证发布 - 详情请参阅 LICENSE 文件。