AI导哈

数据泄露搜索服务器

一个基于Rust的MCP服务器，提供与Snusbase API的集成，用于数据泄露搜索、IP WHOIS查询和哈希值查找。

  • by cbxss
  • Rust
  • 本地部署
  • 更新于
在 GitHub 查看 cbxss/snusbase-mcp

使用说明

Snusbase MCP服务器

一种基于Rust-based的模型上下文协议（MCP）服务器，提供与Snusbase API的集成，用于数据泄露搜索、IP WHOIS查找和哈希查找。

特性

  • 数据库搜索：通过电子邮件、用户名、密码、哈希、名称、IP或域在数据泄露数据库中搜索
  • 数据库统计：获取有关可用违规数据库的元数据
  • IP谁：查找IP地址的注册和地理位置信息
  • 哈希查找：反向查找密码哈希值以查找明文值

先决条件

安装

选项1：快速安装（macOS/Linux）

curl -sSL https://raw.githubusercontent.com/cbxss/snusbase-mcp/main/install.sh | bash

这将自动下载并安装适用于您平台的最新版本。

选项2：下载预构建二进制文件

  1. 从以下网址下载适用于您平台的最新版本 发布:

    • macOS（苹果硅）: snusbase-mcp-macos-aarch64.tar.gz
    • macOS（英特尔）: snusbase-mcp-macos-x86_64.tar.gz
    • Linux（x86_64）: snusbase-mcp-linux-x86_64.tar.gz
    • 视窗: snusbase-mcp-windows-x86_64.zip

  2. 提取存档：

# macOS/Linux
tar xzf snusbase-mcp-*.tar.gz

# Windows: Extract the .zip file
  1. 移动到永久位置（可选）：
# macOS/Linux
sudo mv snusbase-mcp /usr/local/bin/

# Or keep it in your project directory
  1. 设置API密钥（请参阅下面的配置部分）

选项3：从源代码构建

要求：Rust 1.70或更高版本

  1. 克隆存储库：
git clone <repository-url>
cd snusbase-mcp
  1. 构建项目：
cargo build --release
  1. 二进制文件将位于 target/release/snusbase-mcp

配置

通过以下两种方式之一设置Snusbase API密钥：

  1. 环境变量:
export SNUSBASE_API_KEY=sb_your_api_key_here
  1. .env 文件 （推荐）：
SNUSBASE_API_KEY=sb_your_api_key_here

用法

服务器使用MCP协议通过stdin/stdout进行通信，可以与Claude Desktop或其他MCP客户端集成。

MCP客户端配置

添加到您的Claude Desktop配置中：

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

如果使用预构建的二进制文件：

{
  "mcpServers": {
    "snusbase": {
      "command": "/usr/local/bin/snusbase-mcp",
      "env": {
        "SNUSBASE_API_KEY": "sb_your_api_key_here"
      }
    }
  }
}

如果从源代码构建：

{
  "mcpServers": {
    "snusbase": {
      "command": "/path/to/snusbase-mcp/target/release/snusbase-mcp",
      "env": {
        "SNUSBASE_API_KEY": "sb_your_api_key_here"
      }
    }
  }
}

注： 您还可以使用 .env 将文件与二进制文件放在同一目录中，而不是在配置中设置env。

可用工具

snusbase_search

在数据泄露数据库中搜索。

参数：

  • terms （必填）：搜索词数组（例如，电子邮件、用户名）
  • types （必填）：搜索类型数组： email, username, password, hash, name, lastip, _domain
  • wildcard （可选）：启用通配符匹配(% 对于任何字符， _ 对于单个字符）
  • group_by （可选）：如何对结果进行分组（默认值：“db”）
  • tables （可选）：仅限于特定的数据库表

snusbase_status

获取有关可用数据库的统计信息。

参数： 无

snusbase_ipwhois

对IP地址执行WHOIS查找。

参数：

  • terms （必填）：IP地址数组

snusbase_ash_lookup

反向查找密码哈希值。

参数：

  • terms （必填）：密码哈希数组

速率限制

  • 数据库搜索：每12小时2048个请求
  • 其他端点：每分钟512个请求

服务器会自动处理速率限制错误并返回相应的错误消息。

安全

  • 永远不要提交API密钥 到版本控制
  • API密钥应存储在环境变量或 .env 文件（被忽略）
  • 请注意，违规数据可能包含未经修改的HTML或漏洞利用——请谨慎处理输出
  • 此工具只能用于合法的安全研究、授权的渗透测试或防御安全目的

发展

# Run in development mode
cargo run

# Run tests
cargo test

# Format code
cargo fmt

# Lint code
cargo clippy

# Build optimized release binary
cargo build --release

日志被写入 logs/snusbase-mcp.log 每天轮换。

许可证

[在此处添加您的许可证]

免责声明

此工具仅用于授权的安全研究和防御安全目的。用户有责任确保其使用符合适用法律和Snusbase的服务条款。

相关 MCP