Computer Use

Computer Use MCP 服务 🖥️

通过模型上下文协议（MCP）控制虚拟计算机。使用 FastMCP 和 Orgo 构建。

为计算机使用 Agent（CUA）启动云桌面环境。

快速开始

1. 安装依赖

# Create virtual environment
python3 -m venv mcp-env
source mcp-env/bin/activate

# Install packages
pip install fastmcp pydantic orgo

2. 获取 API 密钥

• Orgo API 密钥：在 orgo.ai 注册
• Anthropic API 密钥：从 console.anthropic.com 获取

3. 运行服务

# Set environment variables
export ORGO_API_KEY="your_orgo_key"
export ANTHROPIC_API_KEY="your_anthropic_key"

# Start server
python computer_mcp_server.py

服务运行在 http://127.0.0.1:9000

测试客户端

import asyncio
from fastmcp import Client

async def demo():
    async with Client("http://127.0.0.1:9000/mcp") as client:
        # Initialize computer
        result = await client.call_tool("initialize_computer", {
            "api_key": "your_orgo_key"
        })
        print(f"Computer ready: {result[0].text}")
        
        # Take screenshot
        screenshot = await client.call_tool("get_screenshot")
        print("Screenshot taken!")
        
        # Click and type
        await client.call_tool("left_click", {"x": 100, "y": 200})
        await client.call_tool("type_text", {"text": "Hello World"})
        await client.call_tool("press_key", {"key": "Enter"})

if __name__ == "__main__":
    asyncio.run(demo())

可用工具

工具	说明
initialize_computer	启动虚拟计算机
get_screenshot	截取屏幕
left_click, right_click, double_click	鼠标操作
scroll	向上/向下滚动
type_text, press_key	键盘输入
wait	等待指定秒数
execute_bash	运行终端命令
restart_computer, shutdown_computer	计算机生命周期管理
get_status, list_sessions	状态和会话管理
prompt	Claude AI 计算机使用

Claude AI 计算机使用示例

# Let Claude control the computer
await client.call_tool("prompt", {
    "instruction": "Open Firefox and go to google.com"
})

要求

• Python 3.8+
• Orgo API 密钥
• Anthropic API 密钥（用于 Claude CUA）