Maigret MCP 服务器

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

⚠️ 警告

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

• 仅搜索公开的信息

• 尊重隐私和数据保护法

• 遵守所搜索平台的服务条款

• 负责任地、合乎道德地使用

• 请注意，某些网站可能会限制或阻止自动搜索

Related MCP server: Smart Photo Journal MCP Server

要求

• 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桌面

替代设置（来自源）

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

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 格式

• 网站过滤：按网站标签过滤搜索（例如，照片、约会、我们）

• 基于 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桌面

错误消息

• “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文件。