Which integrations are available for this server?

Enables computer control on Linux systems including shell command execution, file operations, keyboard/mouse input via xdotool, window management via wmctrl, clipboard operations via xclip, and screenshot capture via scrot. Enables computer control on macOS systems including shell command execution, file operations, keyboard/mouse input via osascript, window management, clipboard operations via pbcopy/pbpaste, and screenshot capture via screencapture. Provides a persistent key-value store with collections using SQLite database for CRUD operations including create, read, update, delete, and query with filters.

How do I use OODA Computer Control?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@OODA Computer Control take a screenshot and save it to my desktop" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mnehmos.ooda.mcp (v1.0.0)

npm version License: MIT

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.

Features

Category	Tools	Description
CLI & Files	23	Shell commands, file read/write/copy/move/delete, search, diff editing
CRUD Database	9	Persistent SQLite key-value store with collections
Screen (Observe)	4	Screenshot, display info, screen change detection
Input (Act)	10	Keyboard typing/shortcuts, mouse move/click/drag/scroll
Window Management	11	List/focus/minimize/maximize/close windows, launch apps
Clipboard	4	Read/write text, HTML, images
System	8	System info, processes, network, notifications
Browser	9	Puppeteer/Playwright automation
Sessions	5	Interactive process sessions (REPLs, SSH)
Config & Analytics	7	Configuration management, usage stats
Search	4	Paginated file search
Generic Batch	1	Universal batch dispatcher for any tool

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

Security Warning

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.

Installation

From npm (Recommended)

npm install -g mnehmos.ooda.mcp

From Source

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

Claude Desktop Configuration

Add to your Claude Desktop config file:

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

If installed via npm:

{
  "mcpServers": {
    "ooda-computer": {
      "command": "npx",
      "args": ["mnehmos.ooda.mcp"]
    }
  }
}

If installed from source:

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

OODA Loop Pattern

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

Observe

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

Orient

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

Decide

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

Act

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

Generic Batch Dispatcher

The batch_tools dispatcher can execute ANY tool in batch mode with unified safety limits:

{
  "tool": "batch_tools",
  "args": {
    "operations": [
      { "tool": "read_file", "args": { "path": "src/index.ts" }, "label": "main" },
      { "tool": "file_info", "args": { "path": "package.json" }, "label": "pkg" },
      { "tool": "exec_cli", "args": { "command": "git status --short" }, "label": "git" }
    ],
    "executionMode": "parallel"
  }
}

Execution Modes

Mode	Description
`parallel`	All operations run concurrently (default)
`sequential`	Operations run one after another, supports `stopOnError`

Safety Limits

Configurable via ~/.mcp/config.json or per-request:

Limit	Default	Description
`maxOperations`	50	Max operations per batch
`maxAggregateChars`	200000	Total output size limit
`maxLinesPerFile`	500	Per-file line truncation
`timeout`	30000	Per-operation timeout (ms)

See ADR-003 for full documentation.

API Reference

CLI & File Operations

Tool	Description
`exec_cli`	Execute shell command
`read_file`	Read file contents
`write_file`	Write content to file
`list_directory`	List directory contents
`read_file_lines`	Read specific line range (token-efficient)
`search_in_file`	Search patterns within a file
`str_replace`	Replace unique string in file
`copy_file`	Copy file/directory
`move_file`	Move/rename file
`delete_file`	Delete file/directory
`file_info`	Get file metadata
`search_files`	Search files by pattern
`batch_*`	Parallel versions of above

Diff-Based Editing

Tool	Description
`edit_block`	Search/replace with fuzzy matching fallback
`apply_diff`	Multiple search/replace in atomic operation
`get_diff_preview`	Preview changes without applying
`batch_edit_blocks`	Sequential edits with partial success
`write_from_line`	Replace content from line N to EOF

CRUD Operations

Tool	Description
`crud_create`	Create record in collection
`crud_read`	Read record by ID
`crud_update`	Update existing record
`crud_delete`	Delete record
`crud_query`	Query with filters
`crud_batch_*`	Parallel versions

Screen Operations

Tool	Description
`screenshot`	Capture screen (region optional)
`get_screen_info`	Display/monitor info
`wait_for_screen_change`	Wait for UI changes
`find_on_screen`	Find text/image (requires OCR)

Input Operations

Tool	Description
`keyboard_type`	Type text
`keyboard_press`	Press key with modifiers
`keyboard_shortcut`	Execute shortcut (e.g., "ctrl+c")
`mouse_move`	Move cursor
`mouse_click`	Click at position
`mouse_drag`	Drag between points
`mouse_scroll`	Scroll wheel
`get_mouse_position`	Current cursor position
`batch_keyboard_actions`	Sequence of keyboard actions
`batch_mouse_actions`	Sequence of mouse actions

Window Operations

Tool	Description
`list_windows`	All open windows
`get_active_window`	Currently focused window
`focus_window`	Bring window to front
`minimize_window`	Minimize window(s)
`maximize_window`	Maximize window
`restore_window`	Restore from min/max
`close_window`	Close window
`resize_window`	Resize window
`move_window`	Move window position
`launch_application`	Start application
`wait_for_window`	Wait for window to appear

Clipboard Operations

Tool	Description
`clipboard_read`	Read text/HTML/image
`clipboard_write`	Write text/HTML
`clipboard_clear`	Clear clipboard
`clipboard_has_format`	Check format availability

System Operations

Tool	Description
`get_system_info`	OS, CPU, memory, uptime
`list_processes`	Running processes
`kill_process`	Kill by PID or name
`get_environment`	Environment variables
`set_environment`	Set environment variable
`get_network_info`	Network interfaces
`wait`	Sleep for milliseconds
`notify`	System notification

Browser Automation

Tool	Description
`launch_browser`	Start Puppeteer/Playwright browser
`close_browser`	Close browser instance
`navigate_page`	Navigate to URL
`get_page_content`	Get page HTML/text/markdown
`click_element`	Click element by selector
`type_text`	Type into input field
`evaluate_js`	Execute JavaScript
`screenshot_page`	Capture page screenshot
`get_console_logs`	Get browser console logs

Interactive Sessions

Tool	Description
`start_process`	Start interactive process (REPL, SSH)
`interact_with_process`	Send input to process
`read_process_output`	Read process stdout
`list_sessions`	List active sessions
`terminate_process`	End process session

Batch Operations

Most tools have dedicated 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
...

Or use the generic batch_tools dispatcher to batch ANY tool.

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": "..." }
  ]
}

Platform Support

Feature	Windows	macOS	Linux
CLI/Files	✅	✅	✅
CRUD	✅	✅	✅
Screenshot	✅ PowerShell	✅ screencapture	✅ scrot
Keyboard	✅ SendKeys	✅ osascript	✅ xdotool
Mouse	✅ user32.dll	⚠️ Limited	✅ xdotool
Windows	✅ user32.dll	✅ osascript	✅ wmctrl
Clipboard	✅ PowerShell	✅ pbcopy/paste	✅ xclip

Configuration

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

{
  "storage": {
    "type": "sqlite",
    "path": "~/.mcp/workspace.db"
  },
  "cliPolicy": {
    "mode": "allow-all",
    "extraBlockedPatterns": [],
    "timeoutMs": 30000
  },
  "crud": {
    "defaultLimit": 1000
  },
  "fileReading": {
    "maxLines": 500,
    "warnAtLines": 100
  },
  "batchOperations": {
    "maxOperations": 50,
    "maxAggregateChars": 200000,
    "maxLinesPerFile": 500,
    "defaultTimeout": 30000,
    "toolLimits": {
      "exec_cli": { "maxOperations": 20, "timeout": 60000 }
    }
  }
}

Development

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

Known Limitations

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

License

MIT License - see LICENSE file.

Changelog

See CHANGELOG.md for version history.

OODA Computer Control