ask-computer-mcp 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 44c339e0d4d6dde120f05c2341ddf3c0cbe01f26efb58ca9b978e9587a76e162
+  data.tar.gz: 733d2d5b48fb2ca45f9fd9289360f5c73cd873485fff00529e41bca19bf0eb24
+SHA512:
+  metadata.gz: 523784511ca3761ce681cd0082114f7db5d4bd86a690af95bb9ab230334bd45c985abc08cfea3d0be56ff727d17294371a6df688f98e39f97b7ca2a790f83074
+  data.tar.gz: be38bc2523fb7500e9ef61dba00bd84af11614bb4b6fceaa3a308aaa3bfc0460cb2519d50d773c3a6b6de25097de17b6a4b2fc0eff82d7e997c22418db3b348b

data/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## [0.1.0] - 2026-08-20
+
+### Added
+
+- Initial release. Wraps the 6 `Ask::Tools::Computer::*` tools plus
+  `InstallerStatus` / `InstallerSetup` as an `Ask::MCP::Server.start_stdio`
+  MCP server (`ask-computer-mcp`).

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kaka Ruto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,74 @@
+# Ask Computer MCP
+
+MCP server exposing the [ask-computer](https://github.com/ask-rb/ask-computer)
+tools over the Model Context Protocol — for **ZCode** and any MCP client.
+
+| Tool | What it does |
+|---|---|
+| `history_status` | Check encrypted Computer History health |
+| `history_query` | Bounded metadata-only history slice |
+| `screenshot` | Desktop screenshot via Cua Driver |
+| `click` | Background click (AX or pixel) |
+| `type` | Background typing |
+| `key` | Single key / key combo |
+| `installer_status` | Is cua-driver installed? Version? |
+| `installer_setup` | One-command install + optional history enable |
+
+## Quick Setup
+
+```bash
+# Install the gem
+gem install ask-computer
+
+# That's it — the MCP server auto-starts Cua Driver when needed.
+# For Computer History (nightly preview):
+ask-computer setup --channel nightly --with-history
+```
+
+## ZCode Configuration
+
+Add to `~/.zcode/cli/config.json`:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "ask-computer-mcp": {
+        "type": "stdio",
+        "command": "ask-computer-mcp"
+      }
+    }
+  }
+}
+```
+
+The server auto-starts the Cua Driver daemon when launched. No manual
+`cua-driver serve` needed — the MCP transport handles it.
+
+## Manual Setup
+
+If you prefer manual control:
+
+```bash
+# Install Cua Driver
+/bin/bash -c "$(curl -fsSL https://cua.ai/driver/install.sh)"
+
+# Start the MCP server
+ask-computer-mcp
+
+# Or use the ask-computer CLI
+ask-computer status
+ask-computer setup --channel nightly --with-history
+```
+
+## Development
+
+```bash
+cd ask-computer-mcp
+bundle install
+bundle exec rake test
+```
+
+## License
+
+MIT — see LICENSE.

data/bin/ask-computer-mcp

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "ask/computer/mcp"
+
+Ask::Computer::MCP.start

data/bin/setup

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+cd "$(dirname "$0")/.."
+
+echo "==> Installing dependencies..."
+bundle install
+
+echo "==> Checking Cua Driver..."
+if command -v cua-driver >/dev/null 2>&1; then
+  echo "  cua-driver found: $(cua-driver --version 2>&1 | head -n 1)"
+else
+  echo "  Installing Cua Driver..."
+  /bin/bash -c "$(curl -fsSL https://cua.ai/driver/install.sh)"
+fi
+
+echo "==> Setup complete!"
+echo ""
+echo "Usage:"
+echo "  ask-computer-mcp                           # start the MCP server"
+echo "  ask-computer status                        # check driver status"
+echo "  ask-computer setup --channel nightly --with-history   # enable history"
+echo ""
+echo "ZCode config (add to ~/.zcode/cli/config.json):"
+echo '  "ask-computer-mcp": { "type": "stdio", "command": "ask-computer-mcp" }'

data/lib/ask/computer/mcp/version.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Ask
+  module Computer
+    module MCP
+      VERSION = "0.1.1"
+    end
+  end
+end

data/lib/ask/computer/mcp.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require "ask-computer"
+require "ask/mcp"
+require_relative "mcp/version"
+
+module Ask
+  module Computer
+    module MCP
+      COMPUTER_TOOLS = [
+        Ask::Tools::Computer::HistoryStatus,
+        Ask::Tools::Computer::HistoryQuery,
+        Ask::Tools::Computer::Screenshot,
+        Ask::Tools::Computer::Click,
+        Ask::Tools::Computer::Type,
+        Ask::Tools::Computer::Key,
+        Ask::Tools::Computer::InstallerStatus,
+        Ask::Tools::Computer::InstallerSetup
+      ].freeze
+
+      ALL_TOOLS = COMPUTER_TOOLS.freeze
+
+      class << self
+        def tools
+          @tools ||= ALL_TOOLS.map(&:new)
+        end
+
+        def start
+          ensure_driver
+          Ask::MCP::Server.start_stdio(
+            name: "ask-computer-mcp",
+            version: VERSION,
+            tools: tools,
+            capabilities: { tools: {} },
+            debug: ENV["DEBUG"] == "1"
+          )
+        end
+
+        def reset!
+          @tools = nil
+        end
+
+        private
+
+        def ensure_driver
+          return if Ask::Computer.installed?
+          warn "[ask-computer-mcp] Cua Driver not found — running installer (stable channel)..."
+          Ask::Computer.install(channel: "stable")
+          unless Ask::Computer.installed?
+            warn "[ask-computer-mcp] Install failed. Install manually: /bin/bash -c \"$(curl -fsSL https://cua.ai/driver/install.sh)\""
+            warn "[ask-computer-mcp] See https://cua.ai/docs/tutorials/drive-your-first-app"
+            return
+          end
+          warn "[ask-computer-mcp] Cua Driver installed: #{Ask::Computer::Installer.version}"
+        end
+      end
+    end
+  end
+end

data/lib/ask-computer-mcp.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "ask/computer/mcp"

metadata

@@ -0,0 +1,129 @@
+--- !ruby/object:Gem::Specification
+name: ask-computer-mcp
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Kaka Ruto
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ask-computer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: ask-mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.6
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.25'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.25'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+description: |
+  Exposes the ask-computer tools (HistoryStatus, HistoryQuery, Screenshot,
+  Click, Type, Key, InstallerStatus, InstallerSetup) as MCP tools. Coding
+  agents like ZCode, Claude Code, or Cursor connect via the ask-computer-mcp
+  stdio executable. The underlying Cua Driver remains the background daemon
+  (cua-driver mcp); ask-computer provides the typed history and installer
+  layer that plain cua-driver mcp does not.
+email:
+- kaka@myrrlabs.com
+executables:
+- ask-computer-mcp
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- bin/ask-computer-mcp
+- bin/setup
+- lib/ask-computer-mcp.rb
+- lib/ask/computer/mcp.rb
+- lib/ask/computer/mcp/version.rb
+homepage: https://github.com/ask-rb/ask-computer
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/ask-rb/ask-computer
+  source_code_uri: https://github.com/ask-rb/ask-computer
+  changelog_uri: https://github.com/ask-rb/ask-computer/blob/master/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.18
+specification_version: 4
+summary: MCP server for computer use — exposes ask-computer tools over the Model Context
+  Protocol
+test_files: []