view-control-mcp-server

🚀 视图控制 MCP 服务器

这是一个基于 MCP 标准 的简单视图控制服务器，可实现鼠标控制、键盘输入、屏幕捕获和视图缩放等功能，为视图控制场景提供便捷解决方案。

🚀 快速开始

安装

npm install view-control-mcp-server

启动服务器

npx view-control-mcp-server

默认情况下，服务器将在 ws://localhost:4010 和 http://localhost:4011 上运行。

✨ 主要特性

• 鼠标控制：支持鼠标移动和点击操作。
• 键盘输入：允许发送任意文本和按键事件。
• 屏幕捕获：可以获取当前屏幕的截图。
• 视图缩放：支持调整显示内容的比例。

📦 安装指南

使用以下命令安装视图控制 MCP 服务器：

npm install view-control-mcp-server

💻 使用示例

基础用法

启动服务器

npx view-control-mcp-server

默认端口设置如下：

• WebSocket 端口：4010
• HTTP 端口：4011

使用 JavaScript 控制鼠标

const { MouseController } = require('view-control-mcp-server');
const mouse = new MouseController();

// 鼠标移动到指定坐标
mouse.moveTo(100, 200);

// 模拟左键点击
mouse.click();

发送文本输入

const { KeyboardController } = require('view-control-mcp-server');
const keyboard = new KeyboardController();

// 输入 "Hello, World!"
keyboard.type("Hello, World!");

获取屏幕截图

const { ScreenController } = require('view-control-mcp-server');
const screen = new ScreenController();

// 捕获屏幕并保存为文件
async function captureScreen() {
  const buffer = await screen.capture();
  // 处理 buffer 数据
}

高级用法

自定义端口和配置文件

可以使用以下选项自定义服务器的端口和配置文件： | 选项 | 描述 | |-----------------------|-------------------------------| | --port | 指定服务器的端口，默认为 4010。| | --ws-port | 指定 WebSocket 端口，默认为 4010。| | --http-port | 指定 HTTP 端口，默认为 4011。 | | --config-file | 使用自定义配置文件。 |

📚 详细文档

配置

可以创建一个 config.json 文件来配置服务器的行为：

{
  "port": 4010,
  "wsPort": 4010,
  "httpPort": 4011,
  "debugMode": true,
  "max_fps": 60,
  "auto_scale": true
}

常见问题

如何处理鼠标事件？

确保你的客户端库正确实现了 MCP 标准，并监听相应的鼠标事件。

如何提高性能？

可以尝试调整 max_fps 和 auto_scale 参数，找到最佳平衡点。

👥 贡献者

• yourusername
• contributor1
• contributor2

📄 许可证

本项目采用 MIT 许可证。