使用说明内容(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)与客户端建立连接,或按需配置其他传输方式。
  • 服务器配置(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 SDK 注册工具、资源和提示模板的实现,以及通过 StdioTransport 的连接启动流程,确保 MCP 客户端能够对三大功能进行远程调用并获得格式化的 JSON-RPC 响应。

信息

分类

AI与计算