mcp-maigret

🚀 Maigret MCP 服务器

Maigret MCP 服务器是 Maigret 的一个 Model Context Protocol (MCP) 服务器。Maigret 是一款强大的开源情报 (OSINT) 工具，可从多个公开来源收集用户账户信息。此服务器提供了在社交网络和网站上搜索用户名以及分析 URL 的工具，并且设计用于与兼容 MCP 的应用程序（如 Claude Desktop）无缝集成。

🚀 快速开始

使用 Smithery 安装

1. 打开终端并运行以下命令：

   npm install -g maigret
   

2. 启动服务：

   maigret serve
   

手动安装

1. 克隆仓库：

   git clone https://github.com/yourusername/maigret.git
   cd maigret
   

2. 安装依赖项并构建：

   npm install
   npm run build
   

3. 配置环境变量 MAIGRET_REPORTS_DIR，例如：

   export MAIGRET_REPORTS_DIR="/path/to/reports"
   

4. 启动服务：

   npm start
   

✨ 主要特性

工具

1. search_username
   • 描述：在多个社交网络和网站上搜索用户名。
   • 参数：

     {
       "username": "target_user",
       "format": "pdf" // 可选：txt, html, json, csv
     }
     

2. parse_url
   • 描述：分析指定 URL 的内容并提取情报。
   • 参数：

     {
       "url": "https://example.com/profile",
       "format": "txt" // 可选：pdf, html, json, csv
     }
     

📦 安装指南

安装要求

• Node.js 和 npm：需要 Node.js 8 或更高版本以及 npm。
• Docker：需要 Docker 1.20 或更高版本。
• 操作系统兼容性：支持 Linux、macOS 和 Windows（需安装 Docker Desktop）。

可选设置：从源代码安装

1. 克隆仓库：

   git clone https://github.com/yourusername/maigret.git
   cd maigret
   

2. 安装依赖项并构建：

   npm install
   npm run build
   

3. 配置 MAIGRET_REPORTS_DIR 环境变量，例如：

   export MAIGRET_REPORTS_DIR="/path/to/reports"
   

4. 启动服务：

   npm start
   

🔧 技术细节

故障排除

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 守护进程。
• "MAIGRET_REPORTS_DIR 环境变量未设置"：将环境变量添加到配置中。
• "创建报告目录时出错"：检查目录权限和路径。
• "执行 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，具体内容请参阅 LICENSE 文件。

⚠️ 重要提示

请合法、负责任地使用此工具。仅用于合规用途，尊重隐私和数据保护法律。