View Control MCP Server

🚀 視圖控制 MCP 服務器

這是一個基於 MCP 標準 的簡單視圖控制服務器，可實現鼠標控制、鍵盤輸入、屏幕捕獲和視圖縮放等功能，為視圖控制場景提供便捷的解決方案。

🚀 快速開始

安裝

npm install view-control-mcp-server

啟動服務器

npx view-control-mcp-server

默認情況下，服務器將在 ws://localhost:4010 和 http://localhost:4011 上運行。

✨ 主要特性

• 鼠標控制：支持鼠標移動和點擊操作。
• 鍵盤輸入：允許發送任意文本和按鍵事件。
• 屏幕捕獲：可以獲取當前屏幕的截圖。
• 視圖縮放：支持調整顯示內容的比例。

📦 安裝指南

npm install view-control-mcp-server

💻 使用示例

基礎用法

使用 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 數據
}

高級用法

服務器啟動選項

📚 詳細文檔

配置

可以創建一個 config.json 文件來配置服務器的行為：

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

常見問題

如何處理鼠標事件？

確保你的客戶端庫正確實現了 MCP 標準，並監聽相應的鼠標事件。

如何提高性能？

可以嘗試調整 max_fps 和 auto_scale 參數，找到最佳平衡點。

📄 許可證

本項目採用 MIT 許可證。

👥 貢獻者

• yourusername
• contributor1
• contributor2