Skip to content
MCP server

Optics

Let an AI agent drive Android, iOS, TV and web apps, and save the steps as test suites

Runs locallyStatus and history
Pricing
Open source
Platforms
Android, iOS, Web
Runs
Locally
Version
1.11.0
Listing updated
2 days ago

About Optics

Optics is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Optics is an open-source test automation framework, and its MCP server gives an agent eyes and hands on a device. The agent starts a session, looks at the screen, taps and types, and every action returns what changed. When it finishes, the steps it ran can be read back as a ready CSV or YAML suite.

That suite is plain text that lives in your repository and runs later with optics execute, so a recording becomes an ordinary code-review change. The site gives an example where a moved sign-in button produces a one-locator diff with a text fallback beside it. When an element id stops matching, Optics falls back to finding the element by its text.

The server runs locally over stdio and is installed through uv and a Claude Code or Cursor plugin. Android and iOS need an Appium server with the matching driver, and web uses Playwright Chromium. The project is Apache 2.0 and needs Python 3.12 or newer.

Install

Run in a terminal

claude mcp add optics -- npx -y https://github.com/mozarkai/optics-agent-plugins/releases/download/mcpb-v1.11.0/optics-framework-1.11.0.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "optics": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/mozarkai/optics-agent-plugins/releases/download/mcpb-v1.11.0/optics-framework-1.11.0.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "optics": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/mozarkai/optics-agent-plugins/releases/download/mcpb-v1.11.0/optics-framework-1.11.0.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "optics": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/mozarkai/optics-agent-plugins/releases/download/mcpb-v1.11.0/optics-framework-1.11.0.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "optics": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/mozarkai/optics-agent-plugins/releases/download/mcpb-v1.11.0/optics-framework-1.11.0.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "optics": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/mozarkai/optics-agent-plugins/releases/download/mcpb-v1.11.0/optics-framework-1.11.0.mcpb"
      ]
    }
  }
}

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

start_session
Opens a session on a device or browser, for example with the appium driver.
tap
Taps a target on screen and can assert that expected text is present afterwards.

What it does

Agent-driven sessions
The agent opens a session on a phone, TV or browser through ten tools.
Suites as plain text
Recorded steps are written as CSV or YAML you can review in a pull request.
Text fallback locators
When an id no longer matches, an element can be found by its visible text.
Several platforms
Targets Android, iOS, Android TV, Samsung Tizen, LG webOS and web.
Live recording
The optics live command records working steps and saves them as modules.
Plugin install
A Claude Code and Cursor plugin adds the server and a skill for the suite format.

Good for

  • Have an agent explore a page and write a regression test
  • Turn a manual checkout flow into a repeatable suite
  • Run the same suite on every build in CI
  • Review a locator change as a normal diff
  • Test a smart TV app from an agent session

Pricing

Open source

Apache 2.0

Prices change. Check optics-framework.org before you buy.

Optics FAQ

What do I need installed?

uv on your PATH, Python 3.12 or newer, Appium with UiAutomator2 or XCUITest for mobile, and a Playwright Chromium build for web.

Why does the server show as failed on first start?

The first launch downloads the package and can take a minute or two, longer than Claude Code's 30 second limit; warm the cache once or raise MCP_TIMEOUT.

Which AI models can write tests?

The optics live AI mode works with Gemini, Claude, OpenAI or a local model.

What is the licence?

Apache 2.0.

Is Optics free?

Yes. Optics is open source, so you can use and self-host it for free.

How do I add Optics to Claude Code?

Run this command in your terminal: claude mcp add optics -- npx -y https://github.com/mozarkai/optics-agent-plugins/releases/download/mcpb-v1.11.0/optics-framework-1.11.0.mcpb

What are the best alternatives to Optics?

The closest alternatives to Optics are REA, Browser Use, Scrapling MCP Server, Codebase Memory and GitHub.

Alternatives to Optics

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  3. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  4. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  5. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  6. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools