Computer Control

🚀 計算機控制MCP

MCP服務器提供了計算機控制功能，涵蓋鼠標、鍵盤操作以及OCR等。它藉助PyAutoGUI、RapidOCR和ONNXRuntime實現，類似於Anthropic的'computer - use'，且無需外部依賴。

🚀 快速開始

使用uvx進行MCP設置

{
  "mcpServers": {
    "computer-control-mcp": {
      "command": "uvx",
      "args": ["computer-control-mcp@latest"]
    }
  }
}

通過pip全局安裝

pip install computer-control-mcp

安裝完成後，運行服務器：

computer-control-mcp # 而不是使用uvx computer-control-mcp，這樣您可以使用最新版本。還可以使用`uv cache clean`清除緩存並再次使用`uvx`以獲取最新版本。

✨ 主要特性

• 控制鼠標移動和點擊
• 在當前光標位置輸入文本
• 捕獲整個屏幕或特定窗口的截圖，可選保存到下載目錄
• 使用OCR（光學字符識別）從截圖中提取文字
• 列出並激活窗口
• 按下鍵盤按鍵
• 拖放操作

📦 安裝指南

通過uvx配置

{
  "mcpServers": {
    "computer-control-mcp": {
      "command": "uvx",
      "args": ["computer-control-mcp@latest"]
    }
  }
}

通過pip全局安裝

pip install computer-control-mcp

💻 使用示例

基礎用法

以下是一些基礎操作的代碼示例：

# 鼠標點擊
from computer_control_mcp import click_screen
click_screen(100, 200)

# 輸入文本
from computer_control_mcp import type_text
type_text("Hello, World!")

高級用法

以下是使用OCR進行屏幕文字提取的示例：

from computer_control_mcp import take_screenshot
result = take_screenshot(with_ocr_text_and_coords=True)
print(result)

📚 詳細文檔

可用工具

鼠標控制

• click_screen(x: int, y: int)：在指定屏幕座標處點擊
• move_mouse(x: int, y: int)：將鼠標光標移動到指定座標
• drag_mouse(from_x: int, from_y: int, to_x: int, to_y: int, duration: float = 0.5)：從一個位置拖動鼠標到另一個位置

鍵盤控制

• type_text(text: str)：在當前光標位置輸入指定文本
• press_key(key: str)：按下指定的鍵盤按鍵

屏幕和窗口管理

• take_screenshot(title_pattern: str = None, use_regex: bool = False, threshold: int = 60, with_ocr_text_and_coords: bool = False, scale_percent_for_ocr: int = 100, save_to_downloads: bool = False)：捕獲屏幕或窗口，可選OCR
• get_screen_size()：獲取當前屏幕分辨率
• list_windows()：列出所有打開的窗口
• activate_window(title_pattern: str, use_regex: bool = False, threshold: int = 60)：將指定窗口帶到前臺

API參考

查看API參考獲取詳細信息，瞭解可用函數和類的詳細信息。

🔧 技術細節

本項目使用了PyAutoGUI、RapidOCR和ONNXRuntime實現計算機控制和OCR功能。PyAutoGUI用於鼠標和鍵盤控制，RapidOCR和ONNXRuntime用於光學字符識別。項目無外部依賴，僅在Windows上進行過測試，但其他平臺可能也能使用。

📄 許可證

本項目採用MIT許可證。

更多信息或幫助

• 郵箱 (abcd49800@gmail.com)
• Discord鏈接

⚠️ 重要提示

本項目僅在Windows上測試過，其他平臺可能也能使用，但不保證兼容性。

💡 使用建議

若想使用最新版本，可直接運行computer-control-mcp；若需更新緩存，可使用uv cache clean清除緩存並再次使用uvx以獲取最新版本。