内容
# Tangxin Download — 糖心Vlog MCP Server
糖心Vlog 视频搜索 & 下载工具。零登录零付费，标准 MCP 协议。
## 快速开始
```bash
# 1. 安装依赖
pip install requests fastmcp
# 2. 安装系统工具
# Windows: scoop install aria2 ffmpeg
# macOS: brew install aria2 ffmpeg
# Linux: sudo apt install aria2 ffmpeg
# 3. 修改配置（可选）
# 编辑 config.json，调整下载目录、端口等
# 4. 启动 MCP Server
python server.py
# 5. CLI 使用
python main.py search "关键词"
python main.py download 31570
python main.py home
```
## 配置文件 `config.json`
```json
{
"download_dir": "downloads",
"mcp_host": "0.0.0.0",
"mcp_port": 8766,
"aria2_args": ["--disable-ipv6", "-j16", "-x4", "-s4"],
"referer": "https://tangxinvlog.app/"
}
```
| 字段 | 说明 | 默认值 |
|------|------|--------|
| `download_dir` | 下载输出目录（绝对路径或相对路径） | `downloads` |
| `mcp_host` | MCP 监听地址 | `0.0.0.0` |
| `mcp_port` | MCP 监听端口 | `8766` |
| `aria2_args` | aria2 额外参数 | `--disable-ipv6 -j16 -x4 -s4` |
| `referer` | CDN 请求 Referer 头 | `https://tangxinvlog.app/` |
## MCP 工具
| 工具 | 参数 | 说明 |
|------|------|------|
| `tx_search_posts` | `keyword`, `page` | 搜索视频 |
| `tx_get_post_detail` | `post_id` | 视频详情（含 m3u8） |
| `tx_download` | `post_id` | 异步下载视频 |
| `tx_check_download` | `task_id` | 查询下载进度 |
| `tx_browse_home` | — | 主页推荐 |
| `tx_browse_actor` | `actor_slug` | 演员全部作品 |
## 接入 AI 平台
### Claude Desktop
```json
{
"mcpServers": {
"tangxin": {
"command": "python",
"args": ["path/to/tangxin-download/server.py"]
}
}
}
```
### Cursor
```json
{
"mcpServers": {
"tangxin": {
"command": "python",
"args": ["path/to/tangxin-download/server.py"]
}
}
}
```
### OpenCode / Codex
将 `SKILL.md` 放入 skill 目录即可。支持的项目级路径：
- `项目/.opencode/skills/`
- `~/.config/opencode/skills/`
### 通用 MCP 客户端
支持任何实现 MCP 协议的客户端，连接 `http://host:8766/mcp`。
## 服务器部署
```bash
# 上传项目到服务器后
pip install requests fastmcp
sudo apt install aria2 ffmpeg -y
# 编辑 config.json 按需调整
# 创建 systemd 服务
sudo tee /etc/systemd/system/tangxin-mcp.service << 'EOF'
[Unit]
Description=Tangxin Download MCP Server
After=network.target
[Service]
Type=simple
WorkingDirectory=/path/to/tangxin-download
ExecStart=/usr/bin/python3 server.py
Restart=always
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable --now tangxin-mcp
```
## 技术细节
- **网站**：`tangxinvlog.app`（Astro SSR，数据在 HTML 中）
- **CDN**：`t.5gcdn.xyz`（仅需 Referer 头，无鉴权）
- **视频**：HLS + AES-128 加密（key 公开可下）
- **搜索**：Sitemap 全文匹配（~2900 条索引）
- **下载**：aria2 并行 TS → ffmpeg 解密合并
## 项目结构
```
tangxin-download/
├── server.py # MCP Server
├── main.py # CLI
├── config.json # 配置文件
├── engine/
│ ├── search.py # 搜索 + 详情提取
│ └── download.py # 下载管线
├── README.md
├── SKILL.md
└── downloads/ # 下载输出
```
## 免责声明
> ⚠️ **本项目仅供技术研究和学习目的。**
>
> 项目不包含、不托管、不分发任何视频内容。使用者应自行遵守所在地法律法规，对自身行为承担全部责任。
>
> 完整声明见 [DISCLAIMER.md](DISCLAIMER.md)。
MCP 市场