使用说明
Sherlock MCP服务器
官员 模型上下文协议(MCP) 服务器 Covertlabs 信息窃取者情报平台。内置于 FastMCP.
夏洛克是什么?
Sherlock允许访问Covertlabs的信息窃取者日志综合数据库,使安全研究人员和威胁情报团队能够:
- 搜索泄露的凭据 通过电子邮件、域名、用户名或密码
- 调查受害者 按IP地址、国家或偷窃者家族
- 检索详细工件 包括凭据、Cookie和浏览器历史记录
特性
- 🔍 12搜索工具 -跨infostealer数据库的全面搜索功能
- 🔐 令牌身份验证 -通过个人访问令牌进行安全访问
- ⚡ 无状态HTTP -可扩展、负载均衡器友好的架构
- 🐳 Docker就绪 -生产就绪的集装箱化
安装
先决条件
- Python 3.11+
- 具有API访问权限的Covertlabs帐户
- 您的个人访问令牌来自 app.covertlabs.io/cli/token
快速开始
# Clone the repository
git clone https://github.com/covertlabs/sherlock-mcp.git
cd sherlock-mcp
# Create virtual environment
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Run the server
python server.py
码头工人
docker compose up --build
配置
通过环境变量进行配置:
| 变量 | 默认值 | 描述 |
|---|---|---|
PORT |
8080 |
服务器端口 |
HOST |
0.0.0.0 |
服务器主机 |
COVERTLABS_API_URL |
https://api.covertlabs.io |
API终点 |
CORS_ORIGINS |
* |
允许的CORS来源 |
LOG_REQUESTS |
false |
启用请求日志记录 |
客户端配置
光标
添加到 ~/.cursor/mcp.json:
{
"mcpServers": {
"sherlock": {
"url": "http://localhost:8080/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
克劳德桌面版
添加到您的Claude Desktop MCP配置中:
{
"mcpServers": {
"sherlock": {
"url": "http://localhost:8080/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
可用工具
请参阅 docs/ 每个工具和响应格式的详细文档文件夹。
搜索工具
| 工具 | 说明 |
|---|---|
search_by_email |
通过电子邮件地址搜索受害者 |
search_by_domain |
按域名搜索受害者 |
search_by_ip |
按IP地址搜索受害者 |
search_by_username |
按用户名搜索受害者 |
search_by_password |
按密码搜索受害者 |
search_text |
跨所有字段的广泛文本搜索 |
search_by_country |
按ISO国家代码搜索 |
search_by_stealer |
按偷窃者恶意软件家族搜索 |
受害者详细信息工具
| 工具 | 说明 |
|---|---|
get_victim_profile |
获取受害者资料和元数据 |
get_victim_credentials |
获取被盗凭证 |
get_victim_cookies |
获取被盗的浏览器Cookie |
get_victim_history |
获取浏览器历史记录 |
认证
此服务器使用 个人访问令牌(PAT) 身份验证。令牌被传递到Covertlabs API。
- 登录到 app.covertlabs.io
- 导航至 CLI令牌
- 复制您的令牌(格式:
cl_pat_V1_...) - 添加到MCP客户端配置
API终点
| 端点 | 方法 | 描述 |
|---|---|---|
/ |
GET | 服务器信息 |
/health |
GET | 健康检查 |
/mcp |
POST | MCP协议端点 |
文档
支持
- 文档: docs.coverlabs.io
- 问题: GitHub问题
- 电子邮件: support@covertlabs.io
许可证
MIT许可证-请参阅 许可证 了解详情。
