Tpc Mcpv2

🚀 總控面板：電腦完全掌控

本項目是一個基於 nut.js 的模型上下文協議（MCP）服務器，可實現對屏幕、鼠標和鍵盤的全面控制，讓你輕鬆掌控電腦。

🚀 快速開始

要將此服務器集成到 Claude for Desktop 中，請按照以下步驟操作：

1. 打開 C:\Users\<YourUsername>\.claude\config.js 文件（如果文件不存在，則創建它）。

2. 在文件末尾添加以下內容：

const pcControl = require('@jasondsmith72/total-pc-control');
pcControl.initialize();

3. 保存文件並重啟 Claude 應用程序。

✨ 主要特性

• 📷 屏幕捕獲：捕捉整個屏幕或特定區域的截圖
• 🖱️ 鼠標控制：移動鼠標指針、點擊（單擊/雙擊）、滾動
• ⌨️ 鍵盤輸入：輸入文本並按鍵盤快捷鍵
• 🪟 窗口管理：查找、聚焦和操作應用程序窗口
• 📋 剪貼板訪問：複製和粘貼文本

📦 安裝指南

先決條件

• Node.js 16 或更高版本
• npm 或 yarn
• cmake-js（用於構建 native 依賴項）

安裝步驟

1. 克隆倉庫：

git clone https://github.com/jasondsmith72/Total-PC-Control.git
cd Total-PC-Control

2. 安裝依賴：

npm install

3. 啟動開發環境：

npm run dev

💻 使用示例

基本功能（所有平臺適用）

屏幕捕獲

// 獲取當前屏幕截圖
captureScreen();
// 捕捉指定區域的截圖
captureRegion(x, y, width, height);

鼠標控制

// 移動鼠標指針到指定座標
mouseMove(x, y);
// 點擊鼠標（左鍵或右鍵）
mouseClick(button='left');
// 滾動鼠標滾輪
mouseScroll(deltaX, deltaY);

鍵盤輸入

// 在當前焦點窗口輸入文本
typeText(text);
// 發送任意組合的按鍵事件
sendKeys(keys);

窗口管理

// 獲取所有打開窗口的信息
getWindowInfo();
// 將指定窗口設為活動窗口
setWindowFocus(title);
// 關閉指定窗口
closeWindow(title);

高級功能（Windows 系統專用）

剪貼板操作

// 複製文本到剪貼板
copyToClipboard(text);
// 從剪貼板粘貼內容
pasteFromClipboard();
// 獲取剪貼板中的圖像並返回 base64 數據
getImageFromClipboard();

Windows UI 自動化工具（PowerShell 驅動）

// 返回指定窗口內控件的詳細信息（名稱、AutomationId、類名等）
getUIElementInfo(windowTitle, options);
// 對指定控件執行操作（點擊、設置值或聚焦）
invokeUIAction(windowTitle, action, options);

📚 詳細文檔

開發指南

• 使用開發模式運行服務器：

npm run dev

• 運行測試用例：

npm test

📄 許可證

本項目採用 MIT 許可證，具體條款請參閱 LICENSE 文件。

⚠️ 重要提示

此軟件能夠通過編程方式控制您的鼠標、鍵盤和其他系統功能。使用本軟件即表示您承認並接受以下事實：

• 通過此工具賦予AI模型對計算機的直接控制可能導致意外後果
• 軟件可以控制您的鼠標、鍵盤和其他系統功能
• 您完全自行承擔使用此軟件的風險
• 本項目創建者和貢獻者不對任何可能因使用此軟件導致的數據丟失或其他後果承擔責任