mnehmos.ooda.mcp (v1.0.0)

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"

... [View full README on GitHub](https://github.com/Mnehmos/mnehmos.ooda.mcp#readme)