MCP-侦探服务器

Name: MCP-侦探服务器
Author: BurtTheCoder

作者：BurtTheCoder205 星标更新：2025-03-03

安装使用来源：spider==github.com

项目介绍

Maigret MCP 服务器

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

⚠️ 警告

此工具旨在用于合法的开源情报研究目的。请：

仅搜索公开可用的信息
尊重隐私和数据保护法律
遵守被搜索平台的服务条款
负责任且道德地使用
注意一些网站可能会对自动化搜索进行速率限制或阻止

要求

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

快速开始

通过 Smithery 安装

要通过 Smithery 自动安装 Maigret for Claude Desktop：

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

手动安装

安装 Docker：
- macOS：安装 Docker Desktop
- Linux：遵循 Docker 引擎安装指南
通过 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 格式
站点过滤：按站点标签（例如，照片、约会、美国）过滤搜索
基于 Docker：在不同环境中提供可靠且一致的执行

工具

1. 用户名搜索工具

名称：search_username
描述：在社交网络和网站上搜索用户名
参数：
- username（必需）：要搜索的用户名
- format（可选，默认值："pdf"）：输出格式（txt、html、pdf、json、csv、xmind）
- use_all_sites（可选，默认值：false）：使用所有可用站点而不是前 500 个
- tags（可选）：用于筛选站点的标签数组（例如，["照片", "约会"]）

示例：

{
  "username": "test_user123",
  "format": "html",
  "use_all_sites": false,
  "tags": ["照片"]
}

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 '添加精彩功能')
推送到分支 (git push origin feature/amazing-feature)
打开拉取请求

许可证

本项目根据 MIT 许可证发布 - 查看 LICENSE 文件获取详细信息。