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 编辑 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 自动安装，可以手动安装：

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

---

Configuration / 配置

Using API Token / 使用 API Token

Via Environment Variable / 通过环境变量 (Recommended):

THEPORNDB_API_KEY=your_token theporndb-mcp

Via Command-Line / 通过命令行:

theporndb-mcp --token=your_token

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

---

Development / 开发

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