Douyin MCP Server

🚀 抖音無水印視頻文本提取 MCP 服務器

本項目是一個基於 Model Context Protocol (MCP) 的服務器，能夠從抖音分享鏈接下載無水印視頻，提取音頻並轉換為文本，為用戶提供便捷的抖音視頻處理服務。

🚀 快速開始

安裝

使用 uvx 安裝（推薦）

uvx douyin-mcp-server

使用 pip 安裝

pip install douyin-mcp-server

啟動服務器

douyin-mcp-server

在Claude Desktop中配置

在你的 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "douyin-mcp": {
      "command": "uvx",
      "args": ["douyin-mcp-server"],
      "env": {
        "DOUYIN_API_KEY": "your-api-key-here"
      }
    }
  }
}

使用MCP工具

獲取無水印下載鏈接

使用 get_douyin_download_link 工具：

# 在Claude中使用，無需API密鑰
get_douyin_download_link("https://v.douyin.com/xxx")

提取視頻文本

使用 extract_douyin_text 工具（需要設置環境變量 DOUYIN_API_KEY）：

# 在Claude中使用
extract_douyin_text("https://v.douyin.com/xxx")

解析視頻信息

使用 parse_douyin_video_info 工具：

parse_douyin_video_info("https://v.douyin.com/xxx")

✨ 主要特性

• 🎵 從抖音分享鏈接獲取無水印視頻
• 🎧 自動提取視頻音頻
• 📝 使用AI語音識別提取文本內容
• 🧹 自動清理中間臨時文件
• 🔧 支持自定義API配置, API 默認使用 SiliconFlow API

📦 安裝指南

安裝依賴

本項目依賴以下環境和庫：

• Python 3.8+
• ffmpeg（系統需要安裝ffmpeg）
• requests
• ffmpeg-python
• tqdm
• mcp

安裝 ffmpeg

macOS

brew install ffmpeg

Ubuntu/Debian

sudo apt update
sudo apt install ffmpeg

Windows

下載並安裝 ffmpeg

💻 使用示例

基礎用法

獲取無水印下載鏈接

# 在Claude中使用，無需API密鑰
get_douyin_download_link("https://v.douyin.com/xxx")

提取視頻文本

# 在Claude中使用，需要設置環境變量 DOUYIN_API_KEY
extract_douyin_text("https://v.douyin.com/xxx")

解析視頻信息

parse_douyin_video_info("https://v.douyin.com/xxx")

高級用法

自定義API配置

extract_douyin_text(
    share_link="your-douyin-link",
    api_base_url="https://your-custom-api.com/transcriptions",
    model="your-custom-model"
)

📚 詳細文檔

API 配置

默認配置

服務器默認使用 SiliconFlow API：

• API URL: https://api.siliconflow.cn/v1/audio/transcriptions
• 模型: FunAudioLLM/SenseVoiceSmall

自定義配置

你可以自定義API配置：

extract_douyin_text(
    share_link="your-douyin-link",
    api_base_url="https://your-custom-api.com/transcriptions",
    model="your-custom-model"
)

環境變量配置

在Claude Desktop的配置文件中設置環境變量：

{
  "mcpServers": {
    "douyin-mcp": {
      "command": "uvx",
      "args": ["douyin-mcp-server"],
      "env": {
        "DOUYIN_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

工具說明

get_douyin_download_link

獲取抖音視頻的無水印下載鏈接，無需API密鑰。

extract_douyin_text

完整的文本提取工具，執行以下步驟：

1. 解析抖音分享鏈接
2. 下載無水印視頻
3. 提取音頻
4. 轉換音頻為文本
5. 清理臨時文件 | 屬性 | 詳情 | |------|------| | 參數 | share_link: 抖音分享鏈接或包含鏈接的文本
   api_base_url: API基礎URL（可選）
   model: 語音識別模型（可選） | | 環境變量 | DOUYIN_API_KEY: 語音識別API密鑰（必需） |

parse_douyin_video_info

僅解析視頻基本信息，不下載視頻。

資源訪問

• douyin://video/{video_id}: 通過視頻ID獲取詳細信息

🔧 技術細節

開發

本地開發

git clone https://github.com/yzfly/douyin-mcp-server.git
cd douyin-mcp-server
pip install -e .

運行測試

python -m douyin_mcp_server.server

📄 許可證

MIT License

注意事項

⚠️ 重要提示

• 確保系統已安裝 ffmpeg
• 需要在環境變量中設置有效的語音識別API密鑰 DOUYIN_API_KEY
• 獲取下載鏈接功能無需API密鑰
• 中間文件會自動清理，不會佔用磁盤空間
• 支持大部分抖音視頻格式

⚠️ 免責聲明

• 使用者對本項目的使用由使用者自行決定，並自行承擔風險。作者對使用者使用本項目所產生的任何損失、責任、或風險概不負責。
• 本項目的作者提供的代碼和功能是基於現有知識和技術的開發成果。作者按現有技術水平努力確保代碼的正確性和安全性，但不保證代碼完全沒有錯誤或缺陷。
• 本項目依賴的所有第三方庫、插件或服務各自遵循其原始開源或商業許可，使用者需自行查閱並遵守相應協議，作者不對第三方組件的穩定性、安全性及合規性承擔任何責任。
• 使用者在使用本項目的代碼和功能時，必須自行研究相關法律法規，並確保其使用行為合法合規。任何因違反法律法規而導致的法律責任和風險，均由使用者自行承擔。
• 使用者不得使用本工具從事任何侵犯知識產權的行為，包括但不限於未經授權下載、傳播受版權保護的內容，開發者不參與、不支持、不認可任何非法內容的獲取或分發。
• 本項目不對使用者涉及的數據收集、存儲、傳輸等處理活動的合規性承擔責任。使用者應自行遵守相關法律法規，確保處理行為合法正當；因違規操作導致的法律責任由使用者自行承擔。
• 使用者在任何情況下均不得將本項目的作者、貢獻者或其他相關方與使用者的使用行為聯繫起來，或要求其對使用者使用本項目所產生的任何損失或損害負責。
• 基於本項目進行的任何二次開發、修改或編譯的程序與原創作者無關，原創作者不承擔與二次開發行為或其結果相關的任何責任，使用者應自行對因二次開發可能帶來的各種情況負全部責任。
• 本項目不授予使用者任何專利許可；若使用本項目導致專利糾紛或侵權，使用者自行承擔全部風險和責任。未經作者或權利人書面授權，不得使用本項目進行任何商業宣傳、推廣或再授權。
• 作者保留隨時終止向任何違反本聲明的使用者提供服務的權利，並可能要求其銷燬已獲取的代碼及衍生作品。
• 作者保留在不另行通知的情況下更新本聲明的權利，使用者持續使用即視為接受修訂後的條款。

作者

• yzfly - yz.liu.me@gmail.com
• GitHub: https://github.com/yzfly

貢獻

歡迎提交 Issue 和 Pull Request！

更新日誌

v1.0.0

• 初始版本
• 支持抖音視頻文本提取
• 支持獲取無水印視頻下載鏈接
• 從環境變量讀取API密鑰
• 自動清理臨時文件
• 支持自定義API配置

v1.1.0

• 修復提取視頻時文件名過長的bug