# Optics

> Optics is an open-source MCP server for developer tools. Let an AI agent drive Android, iOS, TV and web apps, and save the steps as test suites. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Android, iOS, Web, CLI, self-hosted
- **Website:** https://optics-framework.org
- **Repository:** https://github.com/mozarkai/optics-agent-plugins/tree/HEAD/mcpb
- **MCP Registry name:** org.optics-framework/optics
- **Categories:** developer tools, browser automation
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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"
      ]
    }
  }
}
```

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/optics
