# ThePornDB MCP 服务 - Cherry Studio 安装指南（2025 版）
本指南将帮助您在 Cherry Studio 中集成 ThePornDB MCP 服务，以便在 AI 对话中搜索和查询成人视频内容信息。
## 📋 前置要求
- **Cherry Studio**：最新版本（支持 MCP 协议）
- **Python**：3.11 或更高版本
- **uv**（推荐）：现代 Python 工具链，速度比 pip 快 10-100 倍
- **ThePornDB API Token**（可选）：从 https://theporndb.net 获取
---
## ⚙️ 在 Cherry Studio 中配置
### 使用 uvx 自动安装（推荐）
Cherry Studio 会自动从 GitHub 下载并运行服务，无需预先安装！
#### 配置步骤
1. 打开 Cherry Studio
2. 设置 → MCP Servers
3. 点击编辑 JSON
4. 根据需求选择以下配置之一：
#### 使用自己的 Token
```json
{
"mcpServers": {
"theporndb": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/achenglike/theporndb-mcp.git@v1.0.0",
"theporndb-mcp"
],
"env": {
"LOG_LEVEL": "INFO",
"THEPORNDB_API_KEY": "你的API密钥"
}
}
}
}
```
5. 保存配置
**提示**：也可以下载项目中的 [theporndb-mcp-template.json](theporndb-mcp-template.json) 作为参考模板。
---
## 🎮 使用方法
配置完成后，在 Cherry Studio 对话中：
### 示例 1：搜索场景
```
用户: 帮我搜索 2023 年的 brazzers 场景
Cherry Studio: [调用 search_scenes 工具]
找到 42 个 Brazzers 在 2023 年发布的场景：
1. Tropical Vacation (2023-06-15)
2. Poolside Paradise (2023-07-20)
...
```
### 示例 2：获取详细信息
```
用户: 获取 ID 为 abc123 的场景详情
Cherry Studio: [调用 get_content_details 工具]
返回完整的场景元数据...
```
---
## 🛠️ 可用工具
| 工具名称 | 功能 | 参数 |
|---------|------|------|
| `search_scenes` | 搜索场景 | `search_term`, `year` (可选) |
| `search_movies` | 搜索电影 | `search_term`, `year` (可选) |
| `search_jav` | 搜索 JAV | `search_term`, `year` (可选) |
| `get_content_details` | 获取详情 | `content_id`, `content_type` |
| `search_performers` | 搜索演员 | `name` |
| `get_performer_details` | 演员详情 | `performer_id` |
---
