Snusbase MCP服务器
一种基于Rust-based的模型上下文协议（MCP）服务器，提供与Snusbase API的集成，用于数据泄露搜索、IP WHOIS查找和哈希查找。
特性
- 数据库搜索：通过电子邮件、用户名、密码、哈希、名称、IP或域在数据泄露数据库中搜索
- 数据库统计：获取有关可用违规数据库的元数据
- IP谁：查找IP地址的注册和地理位置信息
- 哈希查找：反向查找密码哈希值以查找明文值
先决条件
- Snusbase API密钥（从 snusbase.com)
安装
选项1：快速安装（macOS/Linux）
curl -sSL https://raw.githubusercontent.com/cbxss/snusbase-mcp/main/install.sh | bash这将自动下载并安装适用于您平台的最新版本。
选项2：下载预构建二进制文件
- 从以下网址下载适用于您平台的最新版本 发布:
- 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
- 提取存档：
# macOS/Linux
tar xzf snusbase-mcp-*.tar.gz
# Windows: Extract the .zip file- 移动到永久位置（可选）：
# macOS/Linux
sudo mv snusbase-mcp /usr/local/bin/
# Or keep it in your project directory- 设置API密钥（请参阅下面的配置部分）
选项3：从源代码构建
要求：Rust 1.70或更高版本
- 克隆存储库：
git clone
cd snusbase-mcp- 构建项目：
cargo build --release- 二进制文件将位于
target/release/snusbase-mcp
配置
通过以下两种方式之一设置Snusbase API密钥：
- 环境变量:
export SNUSBASE_API_KEY=sb_your_api_key_here.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,_domainwildcard（可选）：启用通配符匹配(%对于任何字符，_对于单个字符）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的服务条款。