README.md
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 集成
Open Cherry Studio → Settings → MCP Servers 打开 Cherry Studio → 设置 → MCP Servers
Edit JSON and paste the configuration from theporndb-mcp-template.json 编辑 JSON 并粘贴配置（将"你的API密钥"替换为实际 token，可选）
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
Tools 6
search_scenesSearch for adult video scenes.search_moviesSearch for adult movies.search_javSearch for JAV content.get_content_detailsRetrieve complete metadata for a specific content item.search_performersSearch for performers by name.get_performer_detailsRetrieve a performer's profile information.Environment Variables
THEPORNDB_API_KEYrequiredAPI token obtained from theporndb.netTry it
→Search for adult scenes released in 2023 by the studio Brazzers.
→Find information about the performer with ID 12345.
→Search for JAV content related to the term 'example'.
→Get the full metadata for the movie with ID 67890.