Skip to main content
Glama
0PValencia

app-screenshot-mcp

by 0PValencia
README.md
# @0pvalencia/app-screenshot-mcp

MCP Playwright para capturas de UI real.

## Cursor / Claude / VS Code

### Local (recomendado si clonas el repo)

```json
{
  "mcpServers": {
    "app-screenshot": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/app-screenshot-mcp/dist/cli.js"]
    }
  }
}
```

Tras clonar: `npm install && npm run build`.

### npx (sin clonar)

```json
{
  "mcpServers": {
    "app-screenshot": {
      "command": "npx",
      "args": ["-y", "@0pvalencia/app-screenshot-mcp"]
    }
  }
}
```

> Si abres este repo en Cursor y usas `npx`, hace falta `npm install && npm run build` para que el bin local exista. Sin eso, `npx` falla con `app-screenshot-mcp: not found` y el MCP se queda cargando.

## Install / run

```bash
npx -y @0pvalencia/app-screenshot-mcp
```

## Local

```bash
npm install
npm run build
npm start
```

## Tools

- `capture_url` — URL → PNG
- `capture_with_login` — login + selectores → PNG

Tras `npm install`, ejecuta `npx playwright install chromium` si hace falta.

- `app-screenshot`: Chromium (`npx playwright install chromium` si hace falta)

## License

MIT

TDQS

B3.1/5.0

Scored across 2 tools

Disambiguation4/5

The tools are clearly distinguished by their purpose: one captures a public URL, the other handles form-based authentication before capturing. Though both ultimately produce screenshots, the workflow differs enough to avoid confusion.

Naming Consistency4/5

Both tool names start with 'capture_' and follow a verb-led pattern. The second name uses a prepositional phrase ('with_login') but it remains readable and consistent in style.

Tool Count3/5

With only two tools, the server feels minimal. This is borderline for a narrow purpose but is not egregiously thin; the two covered scenarios (public and authenticated) justify the count.

Completeness3/5

The domain is screenshot capture, and the two tools cover basic capture and authenticated capture. However, there are minor gaps such as no support for element screenshots, cookie injection, or alternative rendering options, which agents might need but can work around.

Maintenance

ActivitySlowing
ResponsivenessNo issues