视频馈送器
一个MCP服务器，通过OBS记录错误并使用Gemini进行分析。为克劳德代码而建。
你知道那个你无法描述的bug吗？记录下来，让双子座为你解释。
运作原理
- 你告诉克劳德你想记录一个bug
- 视频馈送器检测到您的窗口，选择正确的窗口，然后告诉OBS开始录制
- 你复制错误并说“完成”
- Video Feeder停止录制，将您的项目上下文上传到Gemini，并返回一份结构化分析，其中可能包含根本原因和后续问题
无上下文切换。不，“让我试着解释一下当我……时会发生什么。”
工具
| 工具 | 它做什么 |
|---|---|
list_windows | 显示所有带ID的可捕获窗口（macOS） |
start_recording | 创建OBS窗口捕获并开始录制 |
stop_and_analyze | 停止录制，发送到Gemini，返回分析 |
analyze_bug | 分析现有视频/屏幕截图（不需要OBS） |
先决条件
- 紫外线 （Python包运行器）
- OBS 工作室 启用WebSocket服务器
- A. Gemini API密钥
- macOS（窗口检测使用CoreGraphics——OBS控制和分析可以在任何地方工作）
设置
1.启用OBS WebSocket
打开OBS，转到 工具>WebSocket服务器设置，并将其打开。默认端口为 4455。如果设置了密码，请记下密码。
2.获取Gemini API密钥
首选 谷歌AI工作室 并创建API密钥。免费套餐每天提供约20个请求。
3.添加到克劳德代码
claude mcp add --transport stdio -s user video-feeder -- uv run /path/to/server.py然后将您的环境变量添加到MCP配置中 ~/.claude.json:
{
"video-feeder": {
"type": "stdio",
"command": "uv",
"args": ["run", "/path/to/server.py"],
"env": {
"GEMINI_API_KEY": "your-key-here"
}
}
}4.重新启动克劳德代码
服务器将显示为 video-feeder 在您的MCP工具中。
用法
记录一个bug
告诉克劳德：
“要记录一个bug”
Claude将检测您的活动窗口，开始OBS录制，等待您再现，然后进行分析。
分析现有文件
将视频或屏幕截图放入对话中：
“分析此错误”+附加文件
根据项目背景
你提供的上下文越多，分析就越好：
“要记录一个bug——在React应用程序上工作，当我滚动侧边栏时看到渲染故障”
环境变量
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
GEMINI_API_KEY | 是 | - | Google AI Studio API密钥 |
GEMINI_MODEL | 没有 | gemini-2.5-flash | 使用Gemini模型 |
OBS_WEBSOCKET_HOST | 没有 | localhost | OBS WebSocket主机 |
OBS_WEBSOCKET_PORT | 没有 | 4455 | OBS WebSocket端口 |
OBS_WEBSOCKET_PASSWORD | 否 | （空） | OBS WebSocket密码 |
分析是如何工作的
Video Feeder会将您的录音发送到Gemini，并给出提示，前提是 开发人员无法描述这个bug --这就是他们录制它的原因。双子座被告知：
- 用时间戳一步一步地准确描述它看到了什么
- 识别错误或意外行为
- 注意任何错误消息或UI状态
- 建议可能的根本原因
- 提出2-3个有针对性的后续问题
该响应的结构可由AI编码助手执行，因此Claude可以立即开始修复。
局限性
- 仅限macOS 用于窗口检测(
list_windows,start_recording随着window_name).您仍然可以使用start_recording与已知window_id在其他平台上，或使用analyze_bug任何地方都有现有文件。 - OBS必须正在运行 用于记录工具。这
analyze_bug该工具在没有OBS的情况下工作。 - 免费双子座套餐 限制为每天约20个请求。集
GEMINI_MODEL尝试不同的模型。
许可证
麻省理工学院