# Cherry Studio MCP 配置指南
> 专门针对 Cherry Studio 用户的配置说明
---
## 📦 前提条件
确保已从 PyPI 安装：
```bash
pip install doubao-douyin-analysis-parse-mcp
```
---
## ⚙️ Cherry Studio 配置
### 1. 打开 MCP 设置
在 Cherry Studio 中：
1. 打开设置（Settings）
2. 找到 MCP 或 Model Context Protocol 配置区域
### 2. 添加服务器配置
添加以下 JSON 配置：
```json
{
"mcpServers": {
"douyin-analyzer": {
"command": "douyin-mcp-server",
"env": {
"DOUBAO_API_KEY": "你的豆包API密钥"
}
}
}
}
```
### 3. 配置说明
**关键点：**
- ✅ `command`: 直接使用 `"douyin-mcp-server"`（不需要 `python -m src`）
- ✅ `env`: 设置豆包 API Key
- ✅ 不需要 `args` 参数
- ✅ 不需要 `cwd` 参数
### 4. 获取豆包 API Key
1. 访问：https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey
2. 登录并创建 API Key
3. 复制 API Key 并替换配置中的 `你的豆包API密钥`
### 5. 重启 Cherry Studio
保存配置后，完全关闭并重新打开 Cherry Studio。
---
## ✅ 验证配置
### 检查 MCP 工具
配置成功后，Cherry Studio 应该能看到一个工具：
**工具名称**：`analyze_douyin_video`
**工具描述**：分析抖音视频内容。可以接收抖音口令或直接的抖音链接。
### 测试使用
在 Cherry Studio 中对 AI 说：
```
分析这个抖音视频：https://v.douyin.com/DGHl69ciWp4/
```
或使用完整口令：
```
帮我看看这个抖音视频：0.05 09/23 https://v.douyin.com/DGHl69ciWp4/ 复制此链接
```
**预期行为**：
1. AI 会调用 `analyze_douyin_video` 工具
2. 显示进度：提取链接 → 获取视频 URL → 分析视频
3. 返回结构化的视频分析结果
---
## 🐛 故障排查
### 问题 1：找不到 MCP 工具
**症状**：Cherry Studio 中看不到 `analyze_douyin_video` 工具
**检查步骤：**
1. **确认安装**
```bash
pip show doubao-douyin-analysis-parse-mcp
```
应该显示包信息。
2. **测试命令**
```bash
douyin-mcp-server
```
应该启动服务器（不会有输出，按 Ctrl+C 退出）。
3. **检查配置**
- 配置 JSON 格式是否正确？
- `command` 是否为 `"douyin-mcp-server"`？
- API Key 是否填写？
4. **完全重启**
- 保存配置
- 完全关闭 Cherry Studio
- 重新打开
---
### 问题 2：工具存在但无法调用
**症状**：能看到工具，但 AI 调用时出错
**可能原因：**
1. **API Key 错误**
- 检查 `DOUBAO_API_KEY` 是否正确
- 确认账户有余额
2. **网络问题**
- 抖音解析 API 是否可访问
- 豆包 API 是否可访问
3. **环境变量未传递**
- 确认 `env` 配置正确
- API Key 前后无空格
---
### 问题 3：命令找不到
**错误**：`command 'douyin-mcp-server' not found`
**解决方案：**
1. **确认安装位置**
```bash
# Windows
where douyin-mcp-server
# macOS/Linux
which douyin-mcp-server
```
2. **使用完整路径**
```json
{
"mcpServers": {
"douyin-analyzer": {
"command": "C:\\Users\\你的用户名\\AppData\\Local\\Programs\\Python\\Python310\\Scripts\\douyin-mcp-server.exe",
"env": {
"DOUBAO_API_KEY": "你的API密钥"
}
}
}
}
```
3. **检查 Python 环境**
```bash
# 确认 pip 安装路径在 PATH 中
python -m site
```
---
### 问题 4：版本冲突
**如果使用了旧版本 v1.0.0**
旧版本有 bug，请升级：
```bash
pip install --upgrade doubao-douyin-analysis-parse-mcp
```
确认版本 >= 1.0.1：
```bash
pip show doubao-douyin-analysis-parse-mcp
```
---
## 🔄 配置对比
### ❌ 错误配置（v1.0.0，不可用）
```json
{
"mcpServers": {
"douyin-analyzer": {
"command": "python",
"args": ["-m", "src"], // ❌ 这样不行
"env": {
"DOUBAO_API_KEY": "xxx"
}
}
}
}
```
### ✅ 正确配置（v1.0.1+）
```json
{
"mcpServers": {
"douyin-analyzer": {
"command": "douyin-mcp-server", // ✅ 直接使用命令
"env": {
"DOUBAO_API_KEY": "xxx"
}
}
}
}
```
---
## 💡 使用技巧
### 1. 自然语言交互
直接对 AI 说：
- "分析这个抖音视频：[链接]"
- "这个抖音讲了什么：[口令]"
- "帮我看看这个做菜视频的食材和步骤：[链接]"
### 2. 支持完整口令
可以直接粘贴抖音分享的完整文本：
```
0.05 09/23 III:/ e@B.tE 今年农户都不易啊，水产水果都滞销 # 螃蟹 https://v.douyin.com/DGHl69ciWp4/ 复制此链接，打开Dou音搜索
```
服务会自动提取其中的链接。
### 3. 教程视频特别优化
对于烹饪、手工等教程类视频，AI 会返回：
- 所需材料/食材清单
- 详细步骤
- 重点提示
---
## 📞 获取帮助
### 文档
- [用户安装使用指南](用户安装使用指南.md)
- [README](README.md)
- [新手指南](新手指南.md)
### 反馈
- GitHub Issues：https://github.com/yourusername/douyin-mcp-server/issues
### 常见问题
- 查看 [README.md](README.md) 的"常见问题"章节
---
## 🎉 配置成功！
配置成功后，你可以：
- ✅ 直接在对话中分析抖音视频
- ✅ 获取结构化的视频内容
- ✅ 教程视频自动提取步骤
**享受智能视频分析吧！** 🚀
