📸 screen-view-mcp

一个强大的模型上下文协议（MCP）工具，使AI助手能够使用Claude Vision API捕获并分析屏幕截图。捕捉屏幕截图，分析屏幕内容，并获得关于桌面界面的AI见解。

✨ 特性

• 📸 即时全屏截图捕获
• 🔍 使用Claude Vision进行AI驱动的场景分析
• 🤖 与兼容MCP的AI助手无缝集成
• 🛠️ 简单配置和设置
• 🔄 支持stdio和SSE传输

🎯 使用案例

• 捕获并分析桌面的屏幕截图
• 分析UI元素和布局
• 使用屏幕截图调试视觉问题
• 获得关于屏幕内容的AI见解
• 记录界面元素和布局
• 屏幕录制和分析
• 带有视觉反馈的桌面自动化

🚀 快速开始

通过npm安装（推荐）

最可靠的安装Screen View MCP的方式是通过npm：

# 安装最新版本
npm install -g screen-view-mcp

# 确保获取到确切的最新版本并避免缓存问题
npm install -g screen-view-mcp@2.0.15  # 替换为最新版本号

然后按照下面“手动配置”部分所示配置您的AI客户端。

手动配置

通过npm安装后，配置您的AI客户端：

对于stdio传输（默认）

Claude Desktop：

• Windows: %APPDATA%/Claude/claude_desktop_config.json
• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Cursor：

• Windows: %APPDATA%/Cursor/mcp.json 或 ~/.cursor/mcp.json
• MacOS: ~/Library/Application Support/Cursor/mcp.json

CLIne：

• ~/.config/cline/mcp.json

Windsurf：

• ~/.config/windsurf/mcp.json

{
  "mcpServers": {
    "screen-view-mcp": {
      "command": "npx",
      "args": [
        "screen-view-mcp@2.0.15"  // 指定确切版本以避免缓存问题
      ],
      "transport": "stdio",
      "env": {
        "ANTHROPIC_API_KEY": "your-anthropic-api-key"
      }
    }
  }
}

对于SSE传输

对于支持SSE传输的客户端或远程连接场景：

{
  "mcpServers": {
    "screen-view-mcp": {
      "command": "npx",
      "args": [
        "screen-view-mcp@2.0.15",
        "--sse",
        "--port", "8080",
        "--host", "localhost"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "your-anthropic-api-key"
      }
    }
  }
}

对于连接到远程SSE服务器（运行在另一台机器上）：

{
  "mcpServers": {
    "screen-view-mcp": {
      "url": "http://your-server-ip:8080/sse",
      "transport": "sse",
      "env": {
        "ANTHROPIC_API_KEY": "your-anthropic-api-key"
      }
    }
  }
}

📝 可用工具

captureAndAnalyzeScreen

捕获并分析当前屏幕内容。

参数：

{
  prompt?: string;      // 自定义分析提示
  modelName?: string;   // 使用的Claude模型
  saveScreenshot?: boolean; // 是否保存本地截图
}

在Claude中的示例用法：

你能分析一下我现在屏幕上的内容并描述布局吗？

故障排除

常见问题

• 无法访问屏幕捕获：确保您的AI客户端具有屏幕捕获权限
• API密钥错误：验证您的Anthropic API密钥有效且正确设置在配置中
• 未找到MCP工具：确保包已全局安装（npm list -g screen-view-mcp）
• 包版本问题：在配置中指定确切版本以避免缓存问题
• 传输问题：确认您正在使用适合客户端的传输模式
  • 对于Claude Desktop，使用stdio传输（默认）
  • 对于支持SSE的客户端，可以使用--sse标志

传输兼容性

以下是不同客户端支持的传输类型：

客户端	支持的传输类型
Claude Desktop	stdio
Cursor	stdio, SSE
Cline	stdio, SSE
Windsurf	stdio, SSE

如果遇到连接错误，请确保您使用了适合客户端的传输配置。

🔧 开发

1. 克隆并安装：

git clone https://github.com/yourusername/screen-view-mcp.git
cd screen-view-mcp
npm install

2. 构建：

npm run build

3. 本地测试：

# 使用stdio传输（默认）测试
node dist/screen-capture-mcp.js --api-key=your-anthropic-api-key

# 使用SSE传输测试
node dist/screen-capture-mcp.js --sse --port 8080 --host localhost --api-key=

📜 许可证

MIT

Smithery 部署

此项目配置为在Smithery上部署，允许通过WebSocket传输托管MCP服务器。

部署要求

• Dockerfile（包含在仓库中）
• smithery.yaml（包含在仓库中）
• Anthropic API Key（配置期间需要）

部署步骤

1. 将服务器添加到Smithery
2. 访问部署选项卡
3. 使用您的Anthropic API Key进行配置
4. 部署服务器

配置选项

• anthropicApiKey（必需）：您的Anthropic API密钥
• verbose（可选）：启用详细日志记录（默认：false）

可用工具

• helloWorld：简单的测试工具，回显一条消息
• captureAndAnalyzeScreen：捕获屏幕截图并使用Claude Vision进行分析

使用示例

捕获并分析屏幕截图

const response = await mcpClient.invoke("captureAndAnalyzeScreen", {
  prompt: "我现在屏幕上的内容是什么？重点关注主要内容。",
  modelName: "claude-3-opus-20240229"
});
console.log(response);