# ThePornDB MCP Service

ThePornDB MCP 服务 - 通过 Model Context Protocol 将 ThePornDB API 暴露给 AI 应用

---

## Features / 功能特性

- **Search Content / 搜索内容**: Search scenes, movies, and JAV content / 搜索场景、电影和 JAV
- **Content Details / 详细信息**: Get complete metadata / 获取完整元数据
- **Performer Lookup / 演员查询**: Search performers and profiles / 搜索演员和资料
- **Automatic Retry / 自动重试**: Built-in retry with exponential backoff / 内置指数退避重试

---

## Quick Start / 快速开始

### Cherry Studio Integration / Cherry Studio 集成

1. Open Cherry Studio → Settings → MCP Servers
   打开 Cherry Studio → 设置 → MCP Servers

2. Edit JSON and paste the configuration from [theporndb-mcp-template.json](theporndb-mcp-template.json)
   编辑 JSON 并粘贴配置（将"你的API密钥"替换为实际 token，可选）

3. Save and start chatting!
   保存并开始对话！

**Example / 示例**:
```
You: 帮我搜索 2023 年的 brazzers 场景
Cherry Studio: [自动调用 search_scenes 工具并返回结果]
```

---

## Available Tools / 可用工具

| Tool / 工具 | Description / 描述 | Parameters / 参数 |
|-------------|-------------------|-------------------|
| `search_scenes` | Search scenes / 搜索场景 | `search_term`, `year` (optional) |
| `search_movies` | Search movies / 搜索电影 | `search_term`, `year` (optional) |
| `search_jav` | Search JAV content / 搜索 JAV | `search_term`, `year` (optional) |
| `get_content_details` | Get content details / 获取详情 | `content_id`, `content_type` |
| `search_performers` | Search performers / 搜索演员 | `name` |
| `get_performer_details` | Get performer profile / 获取演员资料 | `performer_id` |

---

## Installation / 安装

### Manual Installation / 手动安装

If you want to install manually instead of using uvx:
如果不想用 uvx 自动安装，可以手动安装：

```bash
pip install git+https://github.com/achenglike/theporndb-mcp.git@v1.0.0
```

---

## Configuration / 配置

### Using API Token / 使用 API Token

**Via Environment Variable / 通过环境变量 (Recommended)**:
```bash
THEPORNDB_API_KEY=your_token theporndb-mcp
```

**Via Command-Line / 通过命令行**:
```bash
theporndb-mcp --token=your_token
```

Get your token at: https://theporndb.net
获取 token 请访问：https://theporndb.net

---

## Development / 开发

```bash
git clone https://github.com/achenglike/theporndb-mcp.git
cd theporndb-mcp
pip install -e .
pytest
```

---

## License / 许可证

MIT License

---

## Support / 支持

- **Issues / 问题**: https://github.com/achenglike/theporndb-mcp/issues
- **ThePornDB API**: https://theporndb.net