视频分析调试服务

ClipSense MCP Server是一款AI驱动的移动应用调试工具,通过分析屏幕录制视频来识别和修复React Native、iOS和Android应用中的崩溃、UI问题和异常行为。

  • by clipsense
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 clipsense/-mcp-server

使用说明

ClipSense MCP服务器

模型上下文协议(MCP)服务器 ClipSense -通过视频分析进行人工智能驱动的移动调试。

使用AI编码助手分析移动应用程序错误的屏幕记录。即时了解React Native、iOS和Android应用程序中的崩溃、UI问题和意外行为。

兼容性

与多个AI编码助手配合使用 支持MCP(模型上下文协议):

  • 克劳德代码 (VS代码扩展)-完全文件系统访问,处理高达500MB的视频
  • 光标 -通过以下方式提供完整的MCP支持 .cursor/mcp.json
  • 帆板运动 -MCP支持通过 .windsurf/mcp.json
  • 克莱恩 -通过集成市场提供全面的MCP支持
  • Roo Cline/Roo代码 -MCP支持手动配置
  • Continue.dev -MCP支持VS代码和JetBrains IDE
  • OpenAI Codex -全面的MCP支持

重要限制:

  • 克劳德桌面版:由于31MB的文件上传限制,无法正常工作(99.99%的视频超过此限制)
  • 一次性分析:每项分析都是独立的;后续问题需要重新分析视频

特性

  • 视频Bug分析:分析显示移动应用程序问题的本地屏幕录制
  • AI驱动调试:Claude Sonnet 4.5逐帧分析视频以识别问题
  • 多平台支持:适用于React Native、iOS(Swift/Objective-C)、Android(Kotlin/Java)
  • 代码修复建议:获取可操作的建议以修复错误
  • 快速处理:大多数视频约2分钟后显示结果

为什么选择ClipSense?

功能 ClipSense MCP 克劳德桌面 手动调试 屏幕录制工具
视频文件大小限制 500MB 31MB N/A 各不相同
AI分析 ✅ 克劳德·十四行诗4.5✅ (受文件大小限制) ❌ 人工审核 ❌ 无分析
在AI编码助手中工作 ✅ 所有MCP兼容 ❌ 仅限桌面 ❌ ❌
代码修复建议 ✅ 上下文 ✅ (有限) ❌ ❌
时间线细分 ✅ 自动 ❌ ❌ 手册 ❌
根本原因分析 ✅ 自动 ✅ (有限) ❌ 手册 ❌
多格式支持 ✅ 9种格式 ✅ (有限) ✅ ✅
与工作流集成 ✅ IDE原生 ❌ 单独的应用程序 ❌ ❌
处理时间 2-3分钟 即时(上传受限) 小时 N/A

底线:ClipSense是唯一一款将AI驱动的视频分析直接带入您的开发工作流程的工具,支持逼真的文件大小和多种视频格式。

演示

从坠机视频到根本原因,不到3分钟

安装

1.获取API密钥

请求一个免费的API密钥:

curl -X POST "https://api.clipsense.app/api/v1/keys/request" \
  -H "Content-Type: application/json" \
  -d '{"email":"your-email@example.com"}'

查看您的电子邮件以获取API密钥(以开头 cs_sk_).

2.通过npm安装

npm install -g @gburanda/clipsense-mcp-server

3.配置您的AI编码助手

克劳德代码(VS代码扩展)

添加到MCP设置文件中:

macOS/Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json 视窗: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "clipsense": {
      "command": "npx",
      "args": ["-y", "@gburanda/clipsense-mcp-server"],
      "env": {
        "CLIPSENSE_API_KEY": "cs_sk_YOUR_API_KEY_HERE"
      }
    }
  }
}

光标

创建或编辑 .cursor/mcp.json 在项目根目录中:

{
  "mcpServers": {
    "clipsense": {
      "command": "npx",
      "args": ["-y", "@gburanda/clipsense-mcp-server"],
      "env": {
        "CLIPSENSE_API_KEY": "cs_sk_YOUR_API_KEY_HERE"
      }
    }
  }
}

帆板运动

创建或编辑 .windsurf/mcp.json 在项目根目录中:

{
  "mcpServers": {
    "clipsense": {
      "command": "npx",
      "args": ["-y", "@gburanda/clipsense-mcp-server"],
      "env": {
        "CLIPSENSE_API_KEY": "cs_sk_YOUR_API_KEY_HERE"
      }
    }
  }
}

Continue.dev

添加到您的继续配置(VS代码或JetBrains):

{
  "mcpServers": {
    "clipsense": {
      "command": "npx",
      "args": ["-y", "@gburanda/clipsense-mcp-server"],
      "env": {
        "CLIPSENSE_API_KEY": "cs_sk_YOUR_API_KEY_HERE"
      }
    }
  }
}

Cline、Roo Cline、OpenAI Codex

请参阅IDE的MCP配置文档。服务器配置遵循上面显示的相同模式。

4.重新启动IDE

ClipSense MCP工具现在将在您的AI编码助手中可用。

用法

在你的AI编码助手中,只需要求分析一个bug视频:

Analyze this bug video: /Users/me/Desktop/app-crash.mp4

您的AI助手将使用ClipSense MCP服务器:

  1. 上传您的视频
  2. 用人工智能视觉处理它(克劳德·索内特4.5)
  3. 识别错误并提出修复建议

后续问题

每个分析都是独立的。 要就同一视频提出后续问题:

Analyze /Users/me/Desktop/app-crash.mp4 and focus on the network request flow

视频将用你的新问题重新分析。未重新指定视频路径的后续问题将无法访问之前的分析上下文。

支持的视频格式

支持的所有常见格式:

  • MP4、MOV、WebM、AVI、MKV、FLV、MPEG/MPG、3GP、WMV
  • 最大文件大小:500MB
  • 最长持续时间:10分钟
  • 所有格式自动转换为MP4进行处理

示例问题

  • “为什么当我点击登录按钮时,我的应用程序会崩溃?”
  • “是什么导致了个人资料屏幕上的UI故障?”
  • “分析此视频并解释发生了什么”
  • “是什么导致了这种无限滚动问题?”

示例分析输出

当您分析视频时,ClipSense提供:

# ClipSense Analysis Complete 🔍

## Root Cause
Null pointer exception when accessing user.profile.avatar at ProfileScreen.tsx:142

## Timeline
- 0:00-0:15 - User navigates to profile screen
- 0:15-0:18 - App attempts to load avatar image
- 0:18 - Crash occurs (NullPointerException)

## Visual Evidence
127 frames analyzed
Key moments:
- 0:15 (Frame 23): Profile screen rendered, avatar placeholder visible
- 0:18 (Frame 24): White screen (crash)

## Recommended Fix
Add null check before accessing avatar:

```javascript
const avatarUrl = user?.profile?.avatar ?? DEFAULT_AVATAR;

后续步骤

  1. 在ProfileScreen.tsx中添加空安全检查
  2. 为轮廓组件实现误差边界
  3. 为缺失的用户数据添加回退UI

💬 有后续问题吗? 继续与您的AI助手进行此对话 📊 查看完整详细信息: https://clipsense.app/results/job_abc123 📝 分析ID: job_abc123


## Pricing

- **FREE**: 3 analyses per month, no credit card required
- **PRO ($29/mo)**: 50 analyses per month
- **TEAM ($99/mo)**: 300 analyses per month, team collaboration
- **ENTERPRISE (Custom)**: Contact sales for custom pricing

> **Note:** Pricing reflects current backend implementation. Contact support@clipsense.app for custom plans.

## FAQ

### What video formats are supported?
All common video formats: MP4, MOV, WebM, AVI, MKV, FLV, MPEG/MPG, 3GP, and WMV files up to 500MB and 10 minutes duration. All formats are automatically converted to MP4 for processing.

### How long does analysis take?
Most videos are analyzed in 2-3 minutes. Longer videos (5+ minutes) may take up to 5 minutes.

### Is my video data secure?
Yes. Videos are encrypted during upload and storage. All videos are automatically deleted after 24 hours. We never train AI models on your data.

### Can I ask follow-up questions about an analysis?
Each MCP analysis is independent. To explore different aspects of the same bug, re-analyze the video with a more specific question (e.g., "focus on the network request flow").

### What if I run out of free analyses?
You can upgrade to PREMIUM ($19/mo) for unlimited analyses, or wait until next month when your free tier resets.

## Troubleshooting

### Error: "CLIPSENSE_API_KEY not found"
**Solution:** Ensure your MCP settings file has the correct `env` section with your API key:
```json
"env": {
  "CLIPSENSE_API_KEY": "cs_sk_YOUR_KEY_HERE"
}

更新后重新启动IDE。

错误:“找不到命令:npx”

解决方案: 从以下位置安装Node.js(v18+) nodejs.org。然后重新启动终端和IDE。

错误:“上传失败”或“文件太大”

解决方案:

  • 确保视频小于500MB
  • 修剪视频以仅显示相关错误(崩溃时刻+10秒前)
  • 压缩方式: ffmpeg -i input.mp4 -vcodec h264 -acodec aac output.mp4

分析停留在“处理”上

解决方案:

  • 检查状态https://clipsense.app/results/[job_id]
  • 如果卡住超过10分钟,请联系support@clipsense.app带有作业ID

Claude Code看不到ClipSense工具

解决方案:

  1. 验证MCP设置文件位置是否与IDE匹配
  2. 检查MCP配置中的JSON语法错误
  3. 完全重新启动VS代码(Cmd+Q,而不仅仅是关闭窗口)
  4. 尝试 npx @gburanda/clipsense-mcp-server 手动测试安装

支持

  • 文档:https://clipsense.app/docs
  • 问题:https://github.com/clipsense/-mcp-server/issues
  • 电子邮件:support@clipsense.app

许可证

麻省理工学院