What is Mcp Video Analysis

mcp_video_analysis is a service based on the Model Context Protocol (MCP) designed for video content analysis and mind map generation.

Use cases

Use cases include summarizing educational videos, creating mind maps for video content for presentations, and analyzing social media videos for marketing insights.

How to use

To use mcp_video_analysis, clone the project from GitHub, install the necessary dependencies, configure the required API keys in a .env file, and start the service using Node.js. You can then call the video analysis and mind map generation functions through the provided API.

Key features

Key features include video analysis to extract keywords, summaries, and key time points from video URLs, and the ability to generate structured mind maps in JSON, PNG, and interactive HTML formats.

Where to use

mcp_video_analysis can be used in various fields such as education, content creation, and digital marketing, where video content analysis and visualization are essential.

视频分析 MCP 服务 | Video Analysis MCP Service

中文 | English

中文版本

这是一个基于Model Context Protocol (MCP)的服务，用于视频内容分析和思维导图生成。

更新日志

v1.0.0 (2025-04-17)

• 初始版本发布
• 支持视频分析功能
• 支持思维导图生成

v1.0.2 (2025-04-18)

• 优化生成总结的功能
• bugfix: 修复生成mindmap.json时，参数错误的问题
• refactor: 重构生成思维导图HTML的逻辑
• doc: 新增调用示例 task.md

正在开发

• 支持字幕文件导出
• AI改写
• 展示流 html页面

功能特点

• 视频分析：从视频URL中提取关键词、摘要和关键时间点
• 思维导图生成：基于视频分析结果生成结构化的思维导图
  • 生成JSON格式的思维导图数据（兼容jsMind库）
  • 生成静态PNG图片格式的思维导图
  • 生成交互式HTML格式的思维导图

环境要求

• Node.js >= 14.0.0
• 所需API密钥

  • BILIGPT_API_KEY：用于视频内容分析（支持多种平台）

    • 获取方式：https://bibigpt.co/r/jSeDX0
    • 支持的视频平台：
      • 国内平台：哔哩哔哩、抖音、快手、小红书、西瓜视频、今日头条、可灵、优酷
      • 海外平台：YouTube、TikTok、Instagram、Lemon8

  • DEEPSEEK_API_KEY：用于思维导图JSON生成

克隆项目

git clone https://github.com/tjh19971228/mcp_video_analysis.git
cd mcp_video_analysis

安装

# 安装依赖
npm install
 或者
pnpm install

配置

创建.env文件并设置必要的API密钥：

BILIGPT_API_KEY=your_biligpt_api_key
DEEPSEEK_API_KEY=your_deepseek_api_key

使用方法

启动服务

# 启动MCP服务
node src/index.js

与Claude集成

要在Claude桌面版中使用此MCP服务，编辑claude_desktop_config.json文件：

{
  "mcpServers": {
    "video-analysis": {
      "command": "node",
      "args": [
        "your_project_path/src/index.js"
      ],
      "env": {
        "BILIGPT_API_KEY": "your_biligpt_api_key",
        "DEEPSEEK_API_KEY": "your_deepseek_api_key"
      }
    }
  }
}

API使用示例

视频分析

// 调用视频分析服务
const result = await videoAnalysis.analyzeVideo({
  url: "https://www.bilibili.com/video/BVxxxxxx"
});

// 返回结果包含：
// - keywords: 关键词列表
// - summary: 视频摘要
// - keyTimepoints: 关键时间点列表

生成思维导图

// 生成思维导图JSON
const json = await mindmap.generateMindmapJson({
  keywords: result.keywords,
  summary: result.summary,
  keyTimepoints: result.keyTimepoints
});

// 生成思维导图图片
const imagePath = await mindmap.generateMindmapImage({
  json: json,
  outputPath: "./output/mindmap.png" // 可选，指定输出路径
});

// 生成思维导图HTML
const htmlPath = await mindmap.generateMindmapHtml({
  json: json,
  outputPath: "./output/mindmap.html", // 可选，指定输出路径
  title: "视频思维导图" // 可选，指定标题
});

开发者指南

服务使用官方的Model Context Protocol SDK实现，主要组件包括：

• src/index.js：服务入口，使用MCP SDK创建和启动服务
• src/services/videoAnalysis.js：视频分析服务实现
• src/services/mindmap.js：思维导图生成服务实现

许可证

MIT

English Version

This is a service based on the Model Context Protocol (MCP) for video content analysis and mind map generation.

Changelog

v1.0.0 (2025-04-17)

• Initial release
• Video analysis support
• Mind map generation

v1.0.1 (2025-04-18)

• Optimized summary generation
• bugfix: Fixed parameter error when generating mindmap.json
• refactor: Restructured the logic for generating mind map HTML
• doc: Added usage examples in task.md

Under Development

• Support for exporting subtitle files
• AI Rewriting
• Demo flow HTML page

Features

• Video Analysis: Extract keywords, summaries, and key timepoints from video URLs
• Mind Map Generation: Create structured mind maps based on video analysis results
  • Generate mind map data in JSON format (compatible with jsMind library)
  • Generate mind maps as static PNG images
  • Generate interactive HTML mind maps

Requirements

• Node.js >= 14.0.0
• Required API Keys

  • BILIGPT_API_KEY: For video content analysis (supports multiple platforms)

    • Get it from: https://bibigpt.co/r/jSeDX0
    • Supported video platforms:
      • Domestic (China): Bilibili, Douyin, Kuaishou, Xiaohongshu, Xigua Video, Toutiao, Keling, Youku
      • International: YouTube, TikTok, Instagram, Lemon8

  • DEEPSEEK_API_KEY: For mind map JSON generation

Clone Project

git clone https://github.com/tjh19971228/mcp_video_analysis.git
cd mcp_video_analysis

Installation

# Install dependencies
npm install
 or
pnpm install

Configuration

Create a .env file and set the necessary API keys:

BILIGPT_API_KEY=your_biligpt_api_key
DEEPSEEK_API_KEY=your_deepseek_api_key

Usage

Start the Service

# Start the MCP service
node src/index.js

Claude Integration

To use this MCP service with Claude desktop, edit the claude_desktop_config.json file:

{
  "mcpServers": {
    "video-analysis": {
      "command": "node",
      "args": [
        "your_project_path/src/index.js"
      ],
      "env": {
        "BILIGPT_API_KEY": "your_biligpt_api_key",
        "DEEPSEEK_API_KEY": "your_deepseek_api_key"
      }
    }
  }
}

API Examples

Video Analysis

// Call the video analysis service
const result = await videoAnalysis.analyzeVideo({
  url: "https://www.bilibili.com/video/BVxxxxxx"
});

// The result contains:
// - keywords: List of keywords
// - summary: Video summary
// - keyTimepoints: List of key timepoints

Generate Mind Maps

// Generate mind map JSON
const json = await mindmap.generateMindmapJson({
  keywords: result.keywords,
  summary: result.summary,
  keyTimepoints: result.keyTimepoints
});

// Generate mind map image
const imagePath = await mindmap.generateMindmapImage({
  json: json,
  outputPath: "./output/mindmap.png" // Optional, specify output path
});

// Generate mind map HTML
const htmlPath = await mindmap.generateMindmapHtml({
  json: json,
  outputPath: "./output/mindmap.html", // Optional, specify output path
  title: "Video Mind Map" // Optional, specify title
});

Developer Guide

The service is implemented using the official Model Context Protocol SDK, with the main components including:

• src/index.js: Service entry point, creates and starts the service using the MCP SDK
• src/services/videoAnalysis.js: Video analysis service implementation
• src/services/mindmap.js: Mind map generation service implementation

License

MIT