# v1.0.0 → v1.0.1 迁移指南
> 如果您安装了 v1.0.0 版本，请按此指南升级
---
## 🚨 为什么需要升级？
**v1.0.0 存在严重 Bug**：
- ❌ 从 PyPI 安装后无法正常使用
- ❌ MCP 工具无法被识别
- ❌ Cherry Studio/Cursor 无法调用
**v1.0.1 已修复**：
- ✅ 添加了正确的入口点
- ✅ 可以直接使用命令运行
- ✅ 所有 MCP 客户端都能正常使用
---
## ⚡ 快速升级（2 步）
### 步骤 1：升级包
```bash
pip install --upgrade doubao-douyin-analysis-parse-mcp
```
### 步骤 2：更新配置
**旧配置（v1.0.0，不可用）：**
```json
{
"mcpServers": {
"douyin-analyzer": {
"command": "python",
"args": ["-m", "src"],
"env": {
"DOUBAO_API_KEY": "你的密钥"
}
}
}
}
```
**新配置（v1.0.1）：**
```json
{
"mcpServers": {
"douyin-analyzer": {
"command": "douyin-mcp-server",
"env": {
"DOUBAO_API_KEY": "你的密钥"
}
}
}
}
```
**主要变化：**
- ✅ `command` 改为 `"douyin-mcp-server"`
- ✅ 删除 `args` 配置
- ✅ 不需要 `cwd` 配置
---
## 📝 详细步骤
### 1. 检查当前版本
```bash
pip show doubao-douyin-analysis-parse-mcp
```
如果显示 `Version: 1.0.0`，需要升级。
---
### 2. 卸载旧版本（可选）
```bash
pip uninstall doubao-douyin-analysis-parse-mcp
```
---
### 3. 安装新版本
```bash
pip install doubao-douyin-analysis-parse-mcp
```
或直接升级：
```bash
pip install --upgrade doubao-douyin-analysis-parse-mcp
```
---
### 4. 验证安装
```bash
# 检查版本
pip show doubao-douyin-analysis-parse-mcp
# 应显示 Version: 1.0.1 或更高
# 测试命令
douyin-mcp-server
# 应该启动服务器（按 Ctrl+C 退出）
```
---
### 5. 更新配置
#### Cursor 配置
打开 Cursor 设置 → MCP，修改为：
```json
{
"mcpServers": {
"douyin-analyzer": {
"command": "douyin-mcp-server",
"env": {
"DOUBAO_API_KEY": "你的豆包API密钥"
}
}
}
}
```
#### Cherry Studio 配置
在 Cherry Studio MCP 设置中，修改为：
```json
{
"mcpServers": {
"douyin-analyzer": {
"command": "douyin-mcp-server",
"env": {
"DOUBAO_API_KEY": "你的豆包API密钥"
}
}
}
}
```
#### VSCode 配置
编辑 `settings.json`：
```json
{
"mcp.servers": {
"douyin-analyzer": {
"command": "douyin-mcp-server",
"env": {
"DOUBAO_API_KEY": "你的豆包API密钥"
}
}
}
}
```
---
### 6. 重启客户端
- **Cursor**：完全关闭后重新打开
- **Cherry Studio**：完全关闭后重新打开
- **VSCode**：重新加载窗口
---
## ✅ 验证升级成功
### 测试 1：检查工具列表
在 MCP 客户端中，应该能看到：
**工具名称**：`analyze_douyin_video`
### 测试 2：实际调用
对 AI 说：
```
分析这个抖音视频：https://v.douyin.com/DGHl69ciWp4/
```
**预期结果**：
- ✅ AI 调用工具
- ✅ 显示进度信息
- ✅ 返回视频分析结果
---
## 🆚 版本对比
| 特性 | v1.0.0 | v1.0.1 |
|------|---------|---------|
| PyPI 安装 | ✅ | ✅ |
| 入口点配置 | ❌ 缺失 | ✅ 完善 |
| 命令方式 | ❌ 不可用 | ✅ `douyin-mcp-server` |
| MCP 工具识别 | ❌ 失败 | ✅ 成功 |
| Cherry Studio | ❌ 无法使用 | ✅ 可用 |
| Cursor | ❌ 无法使用 | ✅ 可用 |
| 配置复杂度 | 复杂 | 简单 |
---
## 🐛 常见问题
### Q1: 升级后仍然不工作？
**解决步骤：**
1. 确认版本
```bash
pip show doubao-douyin-analysis-parse-mcp | grep Version
# 应该是 1.0.1 或更高
```
2. 清除旧配置
- 完全删除旧的 MCP 配置
- 添加新配置
- 重启客户端
3. 测试命令
```bash
douyin-mcp-server
```
应该能运行（按 Ctrl+C 退出）
---
### Q2: 命令找不到？
**错误**：`'douyin-mcp-server' is not recognized`
**解决：**
1. 检查 Python Scripts 目录在 PATH 中
```bash
python -m site --user-site
```
2. 使用完整路径
```bash
# Windows
C:\Users\你的用户名\AppData\Local\Programs\Python\Python310\Scripts\douyin-mcp-server.exe
# 在配置中使用完整路径
```
3. 重新安装
```bash
pip uninstall doubao-douyin-analysis-parse-mcp
pip install doubao-douyin-analysis-parse-mcp
```
---
### Q3: 旧配置还能用吗？
**答案**：不能。
v1.0.1 改变了包结构，必须使用新配置：
- ✅ `command: "douyin-mcp-server"`
- ❌ `command: "python", args: ["-m", "src"]`（不再有效）
---
## 📊 迁移检查清单
升级前后检查：
- [ ] 卸载或升级到 v1.0.1
- [ ] 验证版本号 >= 1.0.1
- [ ] 测试 `douyin-mcp-server` 命令可运行
- [ ] 更新 Cursor/Cherry Studio 配置
- [ ] 删除 `args` 和 `cwd` 配置
- [ ] 重启 MCP 客户端
- [ ] 测试实际调用
- [ ] 验证工具可见
- [ ] 确认分析功能正常
---
## 📞 需要帮助？
### 文档
- [Cherry Studio 配置指南](Cherry_Studio配置指南.md)
- [用户安装使用指南](用户安装使用指南.md)
- [README](README.md)
### 反馈
- GitHub Issues：提交问题
- 包含错误信息和配置内容
---
## 🎉 升级完成！
升级成功后，您将享受：
- ✅ 更简单的配置
- ✅ 更稳定的运行
- ✅ 更好的兼容性
**感谢您的耐心！** 🙏
