内容
# TikTok 直播 MCP
一个 MCP（模型上下文协议）服务器，为 Claude、Cursor、VSCode 和任何 MCP 客户端提供 TikTok 直播数据的实时访问：检测谁正在直播、拉取房间和创作者数据、礼物和地区排行榜 - 直接从聊天提示中。
由 [tik.tools](https://tik.tools) 平台提供支持。包含免费层。完整的无掩码排行榜、联赛和游戏板、创作者和送礼者收入、合格创作者招募源和实时事件 WebSocket 可直接在 [tik.tools/pricing](https://tik.tools/pricing) 获取。
## 快速安装
在 [tik.tools/pricing](https://tik.tools/pricing) 获取免费的 API 密钥，然后将服务器添加到您的客户端。
### Claude 桌面版
编辑 `claude_desktop_config.json`:
```json
{
"mcpServers": {
"tiktok-live": {
"command": "npx",
"args": ["-y", "tiktok-live-mcp"],
"env": { "TIKTOOLS_API_KEY": "YOUR_KEY" }
}
}
}
```
### Cursor
添加到 `~/.cursor/mcp.json`（或项目 `.cursor/mcp.json`）：
```json
{
"mcpServers": {
"tiktok-live": {
"command": "npx",
"args": ["-y", "tiktok-live-mcp"],
"env": { "TIKTOOLS_API_KEY": "YOUR_KEY" }
}
}
}
```
### VSCode
添加到 `.vscode/mcp.json`:
```json
{
"servers": {
"tiktok-live": {
"command": "npx",
"args": ["-y", "tiktok-live-mcp"],
"env": { "TIKTOOLS_API_KEY": "YOUR_KEY" }
}
}
}
```
## 工具
| 工具 | 功能 |
|---|---|
| `check_live` | 检查一个或多个创作者是否正在直播（状态、房间 ID、观众人数） |
| `get_live_status` | 快速的单个创作者直播检查 |
| `get_room_info` | 完整的房间信息：主持人、标题、观众人数、开始时间 |
| `get_creator_profile` | 反向查找创作者资料（专业版） |
| `get_creator_earnings` | 创作者的钻石和硬币收入 |
| `get_room_rankings` | 房间内的最佳送礼者和观众排名 |
| `get_popular_live` | TikTok 按地区划分的实时热门直播排行榜（代理商） |
| `find_eligible_creators` | 按地区划分的创作者招募排名（代理商） |
| `get_gift_catalog` | 全球礼物目录：名称、钻石成本、图标 |
| `get_gift_gallery` | 创作者的直播前礼物愿望清单 |
| `get_live_feed` | 在某个地区发现直播（专业版） |
| `get_trending_hashtags` | 热门直播标签及其观众人数 |
| `get_rate_limits` | 您的密钥的层级、限制和剩余配额 |
## 配置
| 环境变量 | 默认值 | 备注 |
|---|---|---|
| `TIKTOOLS_API_KEY` | - | 必需。在 https://tik.tools/pricing 获取免费密钥 |
| `TIKTOOLS_API_BASE` | `https://api.tik.tools` | 仅用于测试时覆盖 |
## 实时事件
对于直播聊天、礼物、战斗和字幕流，请连接 WebSocket：
```
wss://api.tik.tools/?uniqueId=<username>&apiKey=YOUR_KEY
```
完整文档：[tik.tools/docs](https://tik.tools/docs)
## License
MIT
