Windows Remote Control

🚀 MCPControl 控制服務器

MCPControl 是一款專為模型上下文協議（Model Context Protocol）打造的 Windows 控制服務器。它支持通過編程方式對系統進行操作，涵蓋鼠標、鍵盤控制，窗口管理以及屏幕捕獲等實用功能。

⚠️ 重要提示

此項目目前僅支持 Windows 系統。

🚀 快速開始

快速演示（30 秒精彩展示）

想看看 MCPControl 有什麼神奇之處？嘗試我們的交互式演示：

# 使用一條命令運行演示
node demo.cjs

演示內容包括：

1. 展示所有可用的 MCPControl 工具
2. 顯示屏幕尺寸
3. 跟蹤鼠標位置
4. 獲取活動窗口信息
5. 選擇是否截取屏幕並保存到桌面

無需運行其他命令，演示會自動管理 MCPControl 服務器！

⚠️ 重要免責聲明

⚠️ 重要提示

此軟件為實驗性質且可能具有潛在危險。使用本軟件即表示您承認並接受以下內容：

• 通過此工具讓 AI 模型直接控制您的計算機存在固有風險。
• 該軟件可以控制鼠標、鍵盤和其他系統功能，可能導致意外後果。
• 您使用此軟件完全自擔風險。
• 本項目及其貢獻者對因使用此軟件導致的任何損害、數據丟失或其他後果不承擔責任。
• 此工具應在受控環境中使用，並採取適當的安全措施。

請自行承擔風險。

✨ 主要特性

• 窗口管理
  • 列出所有窗口
  • 獲取活動窗口信息
  • 獲取窗口標題
  • 獲取窗口大小和位置
  • 窗口聚焦
  • 窗口縮放
  • 移動窗口
• 鼠標控制
  • 鼠標移動
  • 點擊操作
  • 滾動功能
  • 拖拽操作
  • 鼠標位置跟蹤
• 鍵盤控制
  • 輸入文本
  • 模擬按鍵
  • 處理特殊鍵（如 Tab、Enter）
• 屏幕捕獲
  • 截取窗口內容
  • 截取指定區域
  • 獲取屏幕分辨率
• 剪貼板操作
  • 獲取剪貼板內容
  • 設置剪貼板內容
  • 管理複製粘貼功能

📦 安裝指南

1. 安裝依賴：

   npm install mcp-control
   

2. 創建配置文件（如 config.json）：

   {
     "port": 3000,
     "debug": true,
     "clipboardPath": "%APPDATA%/Clipboard"
   }
   

3. 運行服務器：

   node index.js
   

💻 使用示例

基礎用法

const MCP = require('mcp-control');
const client = new MCP.Client('localhost', 3000);

async function main() {
  await client.connect();
  console.log(await client.getActiveWindow());
  await client.setClipboardContent("Hello, World!");
  await client.disconnect();
}

main().catch(console.error);

📚 詳細文檔

已知限制

• 窗口最小化/還原操作目前不被支持
• 部分屏幕功能可能因環境配置不同而無法正常工作
• get_screenshot 工具與 VS Code 擴展 Cline 不兼容。詳見 GitHub 問題 #1865
• 某些操作可能需要 elevated 權限，具體取決於目標應用程序
• 目前僅支持 Windows 系統
• 使用 Ctrl 鍵組合（如 Ctrl+C、Ctrl+V）可能導致服務器崩潰，原因是 stdio 處理問題。此問題將在即將發佈的版本中通過 MCP 規範的新流式 HTTP 傳輸協議解決。詳見 GitHub 問題 #120

貢獻指南

請參閱 CONTRIBUTING.md

📄 許可證

本項目 licensed under MIT License，具體詳見 LICENSE 文件。

參考資料

• 模型上下文協議文檔