内容
# 谢洛克 MCP 服务器
[模型上下文协议（MCP）](https://modelcontextprotocol.io/)的官方服务器，用于Covertlabs的信息窃取者智能平台。 使用 [FastMCP](https://github.com/jlowin/fastmcp) 构建。
## 什么是谢洛克？
谢洛克提供了对Covertlabs全面的信息窃取者日志数据库的访问，使安全研究人员和威胁情报团队能够：
- **按电子邮件、域名、用户名或密码搜索泄露的凭证**
- **按IP地址、国家或窃取者家族调查受害者**
- **检索包括凭证、Cookie和浏览历史在内的详细证据**
## 功能
- 🔍 **12种搜索工具** - 跨信息窃取者数据库的综合搜索功能
- 🔐 **令牌身份验证** - 通过个人访问令牌的安全访问
- ⚡ **无状态HTTP** - 可扩展的、负载均衡器友好的架构
- 🐳 **Docker就绪** - 生产就绪的容器化
## 安装
### 先决条件
- Python 3.11+
- 具有API访问权限的Covertlabs账户
- 从 [app.covertlabs.io/cli/token](https://app.covertlabs.io/cli/token) 获取的个人访问令牌
### 快速开始
```bash
# 克隆仓库
git clone https://github.com/covertlabs/sherlock-mcp.git
cd sherlock-mcp
# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate # 在Windows上：.venv\Scripts\activate
# 安装依赖项
pip install -r requirements.txt
# 运行服务器
python server.py
```
### Docker
```bash
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
添加到 `~/.cursor/mcp.json`：
```json
{
"mcpServers": {
"sherlock": {
"url": "http://localhost:8080/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
```
### Claude Desktop
添加到您的Claude Desktop MCP配置中：
```json
{
"mcpServers": {
"sherlock": {
"url": "http://localhost:8080/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
```
## 可用工具
请参阅 [docs/](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。
1. 登录 [app.covertlabs.io](https://app.covertlabs.io)
2. 导航到 [CLI令牌](https://app.covertlabs.io/cli/token)
3. 复制您的令牌（格式：`cl_pat_V1_...`）
4. 添加到您的MCP客户端配置中
## API 端点
| 端点 | 方法 | 描述 |
|----------|--------|-------------|
| `/` | GET | 服务器信息 |
| `/health` | GET | 健康检查 |
| `/mcp` | POST | MCP协议端点 |
## 文档
- [工具参考](docs/tools.md) - 详细工具文档
- [响应格式](docs/responses.md) - API响应模式
- [示例](docs/examples.md) - 使用示例
## 支持
- **文档**: [docs.covertlabs.io](https://docs.covertlabs.io)
- **问题**: [GitHub问题](https://github.com/covertlabs/sherlock-mcp/issues)
- **电子邮件**: support@covertlabs.io
## 许可证
MIT许可证 - 参见 [LICENSE](LICENSE) 获取详细信息。
