Skip to content
Back to search

computer-access-mcp

Host-agnostic local desktop context daemon, Web Control Panel, and scoped MCP server

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mark9804--computer-access-mcp/badge.svg)](/listings/mark9804--computer-access-mcp)

HTML

<a href="/listings/mark9804--computer-access-mcp"><img src="/api/listings/mark9804--computer-access-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requirements: Node.js `>= 24.12.0`, pnpm, and Xcode Command Line Tools (`swift` / `clang` on macOS).

pnpm install
pnpm build:storage-lock
pnpm build:native
pnpm build
pnpm serve

When `computer-access-mcp serve` starts, it listens on `127.0.0.1:43180` and prints a local login URL:

Web UI:   http://127.0.0.1:43180/#token=<admin-token>
MCP HTTP: http://127.0.0.1:43180/mcp

1. Open the printed `Web UI` link in your browser (the `#token=...` fragment is stored in `sessionStorage` and immediately cleared from the URL bar). 2. Click **Initialize Encryption Key** on the **Overview & Permissions** tab, grant macOS **Accessibility** (and optional **Input Monitoring**), and click **Start Capture**. 3. Open **MCP Access (Client Tokens)** to generate a scoped token (`camcp_...`) for your AI client.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 115 lines
  1. # computer-access-mcp
  2. Host-agnostic local desktop history daemon, Web Control Panel, and scoped Model Context Protocol (MCP) server.
  3. `computer-access-mcp` captures user-authorized desktop text, selections, input text, and window layout geometry into a local AES-256-GCM segment store. Humans manage permissions, capture scope, retention, and token leases through a local Web UI; AI agents (Antigravity, Claude Code, Cursor, etc.) query retained context through a least-privilege MCP interface.
  4. ## Architecture
  5. ```text
  6. +---------------------------+ Admin Bearer Token +-------------------------------+
  7. | Browser Control Panel | <------------------------------> | computer-access-mcp serve |
  8. | http://127.0.0.1:43180/ | REST /api/* + Static | (Node HTTP Daemon, 127.0.0.1)|
  9. +---------------------------+ +---------------+---------------+
  10. |
  11. +---------------------------+ Scoped Client Lease Token |
  12. | AI Agents (Antigravity, | POST /mcp (Streamable HTTP) |
  13. | Claude Code, Cursor) | <------------------------------------------------+
  14. | or `stdio` proxy CLI | Tools: status/search/read/layout/pause |
  15. +---------------------------+ |
  16. +---------------------------+---------------------------+
  17. | |
  18. v v
  19. +------------------------------+ +------------------------------+
  20. | SegmentStore (AEAD Log) | | Native Collector Supervisor |
  21. | - store.lock (flock/Win32) | | - macOS AX Collector/Worker |
  22. | - store.meta + seg-*.cah | | - AppAdapter Meta-Framework |
  23. | - Keychain / DPAPI 32B Key | | - Pre-read Privacy Gates |
  24. +------------------------------+ +------------------------------+
  25. ```
  26. ## Quickstart
  27. Requirements: Node.js `>= 24.12.0`, pnpm, and Xcode Command Line Tools (`swift` / `clang` on macOS).
  28. ```bash
  29. pnpm install
  30. pnpm build:storage-lock
  31. pnpm build:native
  32. pnpm build
  33. pnpm serve
  34. ```
  35. When `computer-access-mcp serve` starts, it listens on `127.0.0.1:43180` and prints a local login URL:
  36. ```text
  37. Web UI: http://127.0.0.1:43180/#token=<admin-token>
  38. MCP HTTP: http://127.0.0.1:43180/mcp
  39. ```
  40. 1. Open the printed `Web UI` link in your browser (the `#token=...` fragment is stored in `sessionStorage` and immediately cleared from the URL bar).
  41. 2. Click **Initialize Encryption Key** on the **Overview & Permissions** tab, grant macOS **Accessibility** (and optional **Input Monitoring**), and click **Start Capture**.
  42. 3. Open **MCP Access (Client Tokens)** to generate a scoped token (`camcp_...`) for your AI client.
  43. ## Connecting Antigravity / Claude / Cursor via MCP
  44. After creating a Client Token in the Web Control Panel, click **Copy HTTP MCP Config JSON** or **Copy stdio MCP Config JSON**.
  45. ### Option A: Streamable HTTP (Direct)
  46. ```json
  47. {
  48. "mcpServers": {
  49. "computer-access": {
  50. "url": "http://127.0.0.1:43180/mcp",
  51. "headers": {
  52. "Authorization": "Bearer camcp_<your_client_token>"
  53. }
  54. }
  55. }
  56. }
  57. ```
  58. ### Option B: `stdio` Proxy (Recommended for Local Source Checkout)
  59. Use the full `node` and `dist/server/cli.js` paths (the Web Control Panel's **Copy stdio MCP Config JSON** button fills both paths automatically for your machine):
  60. ```json
  61. {
  62. "mcpServers": {
  63. "computer-access": {
  64. "command": "/full/path/to/node",
  65. "args": ["/full/path/to/repo/dist/server/cli.js", "stdio"],
  66. "env": {
  67. "COMPUTER_ACCESS_TOKEN": "camcp_<your_client_token>",
  68. "COMPUTER_ACCESS_URL": "http://127.0.0.1:43180/mcp"
  69. }
  70. }
  71. }
  72. }
  73. ```
  74. ### Exposed MCP Tools
  75. | Tool | Required Scope | Purpose |
  76. |---|---|---|
  77. | `history_status` | `read` | Service state, active capture scope, and retained time range |
  78. | `history_search` | `read` | Search retained observations by keyword, bundle ID, kind, and time window |
  79. | `history_read` | `read` | Read the full observation record by `eventId` or `snapshotId` |
  80. | `history_layout` | `read` | Read window-relative node bounds and text from a surface snapshot |
  81. | `history_pause` | `pause` | Pause active capture immediately (cannot start or resume capture) |
  82. | `history_reload` | `reload` (opt-in) | Hot-reload the native Collector (`collector`) or restart the local daemon (`server`); preserves an already-running scope only, never auto-starts |
  83. ## Built-In Application Adapters
  84. The macOS Collector pairs a thin AX security kernel with eight built-in adapters (`generic` fallback, six declarative adapters, and the custom `wechat` adapter): `vscode-family` (Antigravity, VSCode, Cursor, Windsurf), `browser-family` (Chrome, Chromium, Brave, Edge, Arc, Dia, Vivaldi, Opera, Firefox, Zen, Floorp, Comet, Atlas, Helium), `terminal-family` (Terminal, iTerm2, Ghostty, Warp, Kitty, WezTerm, Rio, Wave), `qq`, `feishu`, `wechat` (WeChat 4.x Qt custom `extractSurface` + `AXParent` ownership proof), and `slack` (Slack). Surface reads batch `AXPosition`/`AXSize`/`AXIdentifier` in metadata queries, fetch `AXStaticText` bounded ranges in a single shot (with `safeTitle`/`AXValue` fallback on verified non-sensitive leaves), and trigger a serial `Return` fast focused read followed by a 200 ms full surface refresh. See [docs/adapters.md](docs/adapters.md).
  85. ## Security Model Summary
  86. - **Pre-Read Blocking**: Password managers (1Password, Apple Passwords, Keychain Access, Bitwarden, Dashlane, LastPass, NordPass, Proton Pass), `com.apple.safari*`, private/incognito browser windows, System UI overlays, locked screens, active Secure Input, and password/protected UI fields are blocked before text extraction.
  87. - **Encrypted at Rest**: Observations are encrypted frame-by-frame using AES-256-GCM in 4 MiB append-only segments (`seg-*.cah`), keyed by a 32-byte master key in macOS Keychain (or Windows DPAPI).
  88. - **Two-Tier Credentials**: Full control requires the local `admin.token` (protected by `Host`/`Origin` validation against DNS rebinding and cross-site requests). Agent tokens store only SHA-256 digests on disk, carry explicit expiration/revocation, and never receive lifecycle start, policy edit, or Forget permissions.
  89. ## Documentation
  90. See [docs/README.md](docs/README.md) for the full design documentation index.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.