A comprehensive MCP (Model Context Protocol) server that provides full computer control capabilities to Claude. Implements the OODA loop (Observe-Orient-Decide-Act) pattern for autonomous computer interaction.

Total: 62 tools with batch/parallel execution support for most operations.

This server provides unrestricted system access. Claude will be able to:

• Execute arbitrary shell commands
• Control keyboard and mouse
• Take screenshots
• Read/write files anywhere
• Manage windows and processes

Use at your own risk in trusted environments only.

git clone https://github.com/Mnehmos/mnehmos.ooda.mcp.git
cd mnehmos.ooda.mcp
npm install
npm run build

Add to your Claude Desktop config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ooda-computer": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-ooda-computer/dist/index.js"]
    }
  }
}

The tools are designed around the OODA (Observe-Orient-Decide-Act) loop:

• screenshot - Capture screen or region (returns base64 or saves to file)
• get_screen_info - Get display/monitor information
• wait_for_screen_change - Detect when screen content changes
• list_windows - See all open applications
• get_active_window - Know current focus
• clipboard_read - Check clipboard contents

• Use CRUD tools to store/retrieve context and state
• file_info, search_files - Understand filesystem state
• list_processes, get_system_info - Understand system state

• Built into Claude's reasoning between observations
• CRUD database for persistent decision context

• keyboard_type, keyboard_shortcut - Type and use hotkeys
• mouse_click, mouse_move, mouse_drag - Mouse control
• focus_window, launch_application - Window control
• clipboard_write - Set clipboard content
• notify - System notifications

Most tools have batch versions for parallel execution:

batch_exec_cli      - Multiple commands in parallel
batch_read_files    - Multiple files in parallel
batch_write_files   - Multiple files in parallel
batch_copy_files    - Multiple copies in parallel
crud_batch_create   - Multiple records in parallel
...

Batch operations return structured results:

{
  "summary": { "total": 5, "successful": 4, "failed": 1, "elapsed_ms": 23 },
  "results": [
    { "index": 0, "success": true, "result": {...} },
    { "index": 1, "success": false, "error": "..." }
  ]
}

Optional config file at ~/.mcp/config.json:

{
  "storage": {
    "type": "sqlite",
    "path": "~/.mcp/workspace.db"
  },
  "cliPolicy": {
    "mode": "allow-all",
    "extraBlockedPatterns": [],
    "timeoutMs": 30000
  },
  "crud": {
    "defaultLimit": 1000
  }
}

npm install      # Install dependencies
npm run build    # Build TypeScript
npm run dev      # Watch mode
npm start        # Run server

• find_on_screen requires additional OCR dependencies (not included)
• macOS mouse position reading returns 0,0 (system limitation)
• Some mouse drag operations may require platform-specific tuning

MIT License - see LICENSE file.

See CHANGELOG.md for version history.