Maigret MCP 服务器

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

⚠️ 警告

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

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

要求

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

快速入门

通过 Smithery 安装

要自动为 Claude Desktop 安装 Maigret，请通过 Smithery 执行以下操作：

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

手动安装

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

npm install -g mcp-maigret

mkdir -p /path/to/reports/directory

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

重新启动 Claude Desktop

替代设置（从源代码）

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

克隆并构建：

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

添加到您的 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 问题

验证 Docker 是否安装并运行：

docker --version
docker ps

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

报告目录问题

验证报告目录：
- MAIGRET_REPORTS_DIR 中指定的目录必须存在
- 您的用户必须对此目录有写入权限
- 检查权限：ls -la /path/to/reports/directory
常见的配置错误：
- 缺少 MAIGRET_REPORTS_DIR 环境变量
- 目录不存在
- 权限不正确
- 路径末尾有斜杠
修复任何问题后：
- 保存配置文件
- 重新启动 Claude Desktop

错误信息

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

贡献

分叉存储库
创建功能分支（git checkout -b feature/amazing-feature）
提交您的更改（git commit -m '添加 amazing 功能'）
推送到分支（git push origin feature/amazing-feature）
打开 Pull Request

许可证

本项目根据 MIT 许可证授权 - 详细内容请参阅 LICENSE 文件。

BurtTheCoder/mcp-maigret

星标增长

证据时间轴