@screenroll/mcp
MCP服务器 屏幕滚动 --让AI代理通过 模型上下文协议.
安全：配对令牌（必填）
WebSocket网桥正在监听 127.0.0.1:9877. 共享秘密是强制性的 因此其他本地进程无法控制记录。
- 打开 屏幕滚动 Chrome浏览器中的扩展程序弹出窗口→ MCP配对.
- 点击 生成配对令牌并启用网桥 一次（一次性）。之后，当Cursor启动此MCP服务器时，扩展会自动重新连接。
- 将令牌从配对屏幕复制到MCP配置中（该页面显示了一个可粘贴的页面
mcp.json示例），或通过以下方式传递相同的值--token,SCREENROLL_MCP_TOKEN，或--token-file.
先决条件
- Node.js≥18
- ScreenRoll Chrome扩展程序 （使用MCP桥）已安装--更新后重新加载扩展。
- MCP服务器处于活动状态时Chrome正在运行
快速启动（光标）
最小安装量仍然是1 npx 命令，但你 必须 从扩展中添加令牌：
{
"mcpServers": {
"screenroll": {
"command": "npx",
"args": ["-y", "@screenroll/mcp", "--token", "PASTE_TOKEN_FROM_EXTENSION"]
}
}
}使用环境变量（如果您的客户端支持 env):
{
"mcpServers": {
"screenroll": {
"command": "npx",
"args": ["-y", "@screenroll/mcp"],
"env": {
"SCREENROLL_MCP_TOKEN": "PASTE_TOKEN_FROM_EXTENSION"
}
}
}
}尽可能避免将秘密放入共享配置中——使用 --token-file:
npx -y @screenroll/mcp --token-file ~/.screenroll-mcp.token如果您启动服务器 没有 象征，它 立即退出 并打印设置说明。
内置医生/自愈
如果重新启动MCP客户端后连接不稳定，请运行：
npx -y @screenroll/mcp doctor --fix此检查端口 9877，清除过时的ScreenRoll MCP进程，并打印JSON运行状况报告。
启动握手探测（v1.0.3+）
启动时，MCP服务器执行扩展握手探测（超时5秒）。 如果没有及时到达扩展握手，它会打印一个可操作的提示，而不是一个通用错误：
- 打开Chrome扩展程序→ MCP配对
- 如果您尚未设置MCP，请单击 生成配对令牌并启用网桥 一次
- 验证MCP配置中的令牌是否与扩展令牌匹配
- 跑
npx -y @screenroll/mcp doctor --fix如有需要
克劳德桌面版
相同的模式 claude_desktop_config.json 在...之下 mcpServers.screenroll.
克劳德代码
claude mcp add screenroll -- npx -y @screenroll/mcp --token YOUR_TOKEN可用工具
| 工具 | 说明 |
|---|---|
start_recording | 开始录制（选项卡或桌面）。参数： mode, quality, includeAudio, includeMic |
pause_recording | 暂停当前录制 |
resume_recording | 恢复暂停的录制 |
stop_recording | 停止录制并保存文件 |
get_status | 当前状态：空闲、录制或暂停 |
list_recordings | 最近的记录（元数据） |
质量预设
| 价值 | 分辨率 | 最适合 |
|---|---|---|
LOW | 720p | 最小文件 |
MEDIUM | 1080p | 常规使用（默认） |
HIGH | 1080p | 细节更清晰 |
PRESENTATION | 1080p | 最佳（最高1080p比特率） |
ULTRA4K | 4K | 最大细节 |
运作原理
AI Agent ←— MCP (stdio) —→ @screenroll/mcp ←— WebSocket + token —→ ScreenRoll extension- MCP进程继续监听 127.0.0.1:9877 对于单个经过身份验证的扩展连接。
- 当您启用配对时，扩展程序会创建令牌；将其复制到MCP客户端配置中。
- 重新生成令牌 在扩展中，旧值无效——重新生成后更新MCP配置。
许可证
麻省理工学院