mcp-maigret

Maigret MCP 服务器

maigret的模型上下文协议 (MCP) 服务器，maigret 是一���强大的开源情报 (OSINT) 工具，可从各种公共来源收集用户账户信息。该服务器提供跨社交网络搜索用户名和分析 URL 的工具。它旨在与Claude Desktop等兼容 MCP 的应用程序无缝集成。

⚠️ 警告

此工具专为合法的开源情报 (OSINT) 研究目的而设计。请：

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

要求

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

快速入门

通过 Smithery 安装

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

手动安装

1. 安装 Docker：
   • macOS：安装Docker Desktop
   • Linux：遵循Docker Engine 安装指南
2. 通过 npm 全局安装服务器：

3. 创建报告目录：

4. 添加到您的 Claude Desktop 配置文件：

配置文件位置：

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

5. 重启Claude桌面

替代设置（来自源）

如果您希望从源代码运行或需要修改代码：

1. 克隆并构建：

2. 添加到您的 Claude Desktop 配置：

特征

• 用户名搜索：在数百个社交网络和网站上搜索用户名
• 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”]）

例子：

2. URL分析工具

• 名称： parse_url
• 描述：解析 URL 以提取信息并搜索相关的用户名
• 参数：
  • url （必填）：需要分析的 URL
  • format （可选，默认值：“pdf”）：输出格式（txt，html，pdf，json，csv，xmind）

例子：

故障排除

Docker 问题

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

2. 检查 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桌面

错误消息

• “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. 打开拉取请求

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。