使用说明内容(Markdown格式)
-
项目简介
- 这是一个基于 MCP 标准的后端服务,向 MCP 客户端提供工具(如获取下载链接、下载视频、解析视频信息)、资源(抖音视频信息)以及可渲染的提示模板,支持通过标准的 JSON-RPC 方式与客户端通信,便于 LLM 集成抖音视频相关功能。
-
主要功能点
- 提供三种核心工具:
- get_douyin_download_link:解析抖音分享链接,获取无水印视频下载地址以及视频信息。
- download_douyin_video:使用分享链接下载视频文件,支持实时下载进度回调。
- parse_douyin_video_info:解析视频信息,返回标题、ID、下载链接等。
- 注册资源 douyin-video,用于通过资源 URI 获取视频基本信息。
- 提供提示模板 douyin_video_download_guide,给 LLMs 提示如何使用该服务器的工具。
- 通过 StdioServerTransport 提供标准输入输出传输,便于与多种 MCP 客户端对接。
- 环境可配置工作目录 WORK_DIR,默认使用 .data,便于本地开发与部署。
- 使用 TypeScript 编写,采用 MCP SDK 封装上传统接口,具备会话管理与能力声明。
- 提供三种核心工具:
-
安装步骤
- 使用 NPX(推荐):
- pnpx @yc-w-cn/douyin-mcp-server
- 全局安装:
- pnpm install -g @yc-w-cn/douyin-mcp-server
- douyin-mcp-server
- 运行后服务器将通过标准输入输出(Stdio)与客户端建立连接,或按需配置其他传输方式。
- 使用 NPX(推荐):
-
服务器配置(JSON,供 MCP 客户端使用,不属于服务器代码)
- 配置示例(以 Claude Desktop 为例,实际可选其他 MCP 客户端):
- JSON 配置示例(请在客户端使用时按如下结构配置,确保服务器名称与启动命令一致): { "mcpServers": { "douyin-mcp-server": { "command": "npx", "args": ["-y", "@yc-w-cn/douyin-mcp-server@latest"], "env": { "WORK_DIR": "/path/to/your/data/directory" } // 该配置用于客户端启动服务器进程并与 MCP 交互 } } }
- 配置要点说明
- server name:douyin-mcp-server,与代码中注册的服务名称一致。
- command:启动服务器所用命令,示例为 npx。
- args:启动参数,确保使用最新版本的服务器包。
- env:可选的环境变量,用于指定工作目录等运行时参数。
-
基本使用方法
- 启动后,MCP 客户端即可通过工具名称调用:
- 获取无水印下载链接(get_douyin_download_link)
- 下载视频(download_douyin_video)
- 解析视频信息(parse_douyin_video_info)
- 客户端通常会将请求以 JSON-RPC 形式发送并接收相应结果与文本内容,以便在对话中直接呈现给用户。
- 若要本地调试,可查看工作目录(默认 .data)下生成的视频文件和日志输出。
- 启动后,MCP 客户端即可通过工具名称调用:
-
运行与测试
- 服务器核心代码包含通过 MCP SDK 注册工具、资源和提示模板的实现,以及通过 StdioTransport 的连接启动流程,确保 MCP 客户端能够对三大功能进行远程调用并获得格式化的 JSON-RPC 响应。
信息
分类
AI与计算