Maigret MCP 服务器

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

<a href="https://glama.ai/mcp/servers/knnpcz651x"><img width="380" height="200" src="https://glama.ai/mcp/servers/knnpcz651x/badge" alt="mcp-maigret MCP server" /></a>

⚠️ 警告

此工具专为合法的 OSINT 研究目的而设计。请：

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

要求

• Node.js (v18 或更高版本)
• Docker
• 安装了 Docker Desktop 的 macOS、Linux 或 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

3. 创建一个报告目录：

mkdir -p /path/to/reports/directory

4. 添加到您的 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

5. 重启 Claude Desktop

替代设置（从源代码）

如果您喜欢从源代码运行或需要修改代码：

1. 克隆和构建：

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

2. 添加到您的 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 格式
• 站点过滤：按站点标签（例如，photo、dating、us）过滤搜索
• 基于 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

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 Desktop

错误消息

• "Docker is not installed or not running"（Docker 未安装或未运行）：安装 Docker 并启动 Docker 守护程序
• "MAIGRET_REPORTS_DIR environment variable must be set"（必须设置 MAIGRET_REPORTS_DIR 环境变量）：将环境变量添加到您的配置
• "Error creating reports directory"（创建报告目录时出错）：检查目录权限和路径
• "Error executing maigret"（执行 maigret 时出错）：检查 Docker 日志并确保容器具有正确的权限

贡献

1. Fork 存储库
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 文件。