Maigret MCP服务器
⚠️ 警告
该工具专为合法的OSINT研究目的而设计。拜托：
- 仅搜索公开信息
- 尊重隐私和数据保护法
- 遵循被搜索平台的服务条款
- 负责任和合乎道德地使用
- 请注意，某些网站可能会限制或阻止自动搜索
安全
此服务器实施了多种安全措施来防止命令注入攻击：
输入验证
- 保护用户名：只允许使用字母数字字符、下划线、连字符和句点（最多100个字符）
- 网址：必须是没有shell元字符的有效HTTP/HTTPS URL
- 标签：只允许使用字母数字字符、下划线和连字符
安全命令执行
- 用途
execFile()而不是exec()防止shell插值 - 所有命令参数都以数组形式传递，而不是连接字符串
- Docker命令在没有shell解释的情况下执行
报告安全问题
如果您发现安全漏洞，请通过打开问题或直接联系维护人员来报告。我们认真对待安全问题，并将迅速作出回应。
需求
- Node.js（v18或更高版本）
- 码头工人
- 安装了Docker Desktop的macOS、Linux或Windows
- 对报告目录的写入权限
快速开始
通过Smithery安装
通过以下方式自动安装Maigret for Claude Desktop 铁匠铺:
npx -y @smithery/cli install mcp-maigret --client claude手动安装
- 安装Docker：
- macOS：安装 - Linux：跟随
- 通过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 - 窗户：
%APPDATA%\Claude\claude_desktop_config.json
- 重新启动克劳德桌面
替代设置（来源）
如果您更喜欢从源代码运行或需要修改代码：
- 克隆和构建：
git clone
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格式
- 网站筛选：按网站标签过滤搜索（例如，照片、约会、我们）
- 基于Docker：跨环境可靠且一致的执行
工具
1.用户名搜索工具
- 姓名：
search_username - 描述：在社交网络和网站上搜索用户名
- 参数：
- username （必填）：要搜索的用户名（字母数字、下划线、连字符、句点；最多100个字符） - format （可选，默认：“pdf”）：输出格式（txt、html、pdf、json、csv、xmind） - use_all_sites （可选，默认值：false）：使用所有可用网站，而不是前500名 - tags （可选）：用于筛选网站的标签数组（仅限字母数字、下划线、连字符）
例子：
{
"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环境变量 - 目录不存在 - 权限不正确 - 小径上的斜线
- 解决任何问题后：
- 保存配置文件 - 重新启动克劳德桌面
错误信息
- “Docker未安装或未运行”：安装Docker并启动Docker守护进程
- “必须设置MAIGRET_REPORTS_DIR环境变量”：将环境变量添加到配置中
- “创建报告目录时出错”：检查目录权限和路径
- “执行maigret时出错”：检查Docker日志并确保容器具有适当的权限
- “无效用户名”：用户名包含无效字符。仅使用字母数字、下划线、连字符和句点
- “无效URL”：URL格式不正确或包含禁止的字符
- “无效标记”：标记包含无效字符。仅使用字母数字、下划线和连字符
贡献
- 分叉存储库
- 创建要素分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。