使用说明
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服务器:
- 上传您的视频
- 用人工智能视觉处理它(克劳德·索内特4.5)
- 识别错误并提出修复建议
后续问题
每个分析都是独立的。 要就同一视频提出后续问题:
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;
后续步骤
- 在ProfileScreen.tsx中添加空安全检查
- 为轮廓组件实现误差边界
- 为缺失的用户数据添加回退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工具
解决方案:
- 验证MCP设置文件位置是否与IDE匹配
- 检查MCP配置中的JSON语法错误
- 完全重新启动VS代码(Cmd+Q,而不仅仅是关闭窗口)
- 尝试
npx @gburanda/clipsense-mcp-server手动测试安装
支持
- 文档:https://clipsense.app/docs
- 问题:https://github.com/clipsense/-mcp-server/issues
- 电子邮件:support@clipsense.app
许可证
麻省理工学院