Maigret OSINT

🚀 Maigret MCP 服务器

这是一个与 maigret 工具兼容的 MCP 服务器，具备用户名搜索、URL 分析功能，还支持多种输出格式，能满足不同场景的需求。

🚀 快速开始

安装 Docker

curl -fsSL https://get.docker.com | bash -s docker

运行服务器

docker run -d --name maigret -e MAIGRET_REPORTS_DIR=/path/to/reports -v /path/to/host/reports:/app/reports maigret/mcp-server:latest

✨ 主要特性

• 用户名搜索：分析指定 URL 下的用户信息。
• URL 分析：提取并报告指定 URL 的详细信息。
• 多格式输出：支持多种输出格式，便于不同需求的使用。

📦 安装指南

示例配置文件（config.json）

{
  "servers": [
    {
      "name": "maigret-server",
      "host": "localhost",
      "port": 8090,
      "username": "admin",
      "password": "password123"
    }
  ],
  "reports_dir": "/path/to/reports",
  "log_level": "info"
}

💻 使用示例

基础用法

查询用户信息

curl -X POST http://localhost:8090/api/search \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/profile","format":"pdf"}'

分析指定 URL

curl -X POST http://localhost:8090/api/analyze \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","format":"json"}'

📚 详细文档

故障排除

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

贡献指南

1. 提交问题：在 GitHub 仓库中提出 issue。
2. 参与开发：

git clone https://github.com/yourusername/maigret-mcp-server.git
cd maigret-mcp-server
git checkout -b feature/new-feature

3. 提交代码：

git add .
git commit -m '添加新功能'
git push origin feature/new-feature

4. 提交拉取请求：在 GitHub 上创建 Pull Request。

📄 许可证

本项目遵循 MIT 许可证，具体内容请参阅 LICENSE 文件。