Skip to main content
Glama
aliksir

neko-browser

by aliksir

neko-browser

Dedicated browser MCP server for neko-gundan agents. Headed Playwright with persistent profile, fully isolated from daily-use Chrome.

Features

  • Persistent profile: Sessions survive restarts (cookies, localStorage, login state preserved)

  • Headed mode: GUI visible by default for debugging and human oversight

  • 23 MCP tools: Full browser automation toolkit

  • PII masking: Sensitive data (credit cards, SSNs, emails) auto-masked in responses

  • Process isolation: Runs its own Chromium instance with dedicated profile directory

  • Custom favicon: Shigoto-neko icon injected for easy identification

Related MCP server: Playwright Server MCP

Tools

Tool

Description

neko_navigate

Navigate to URL, optionally in new tab

neko_click

Click element by index or coordinates

neko_type

Type text into element (keyboard events)

neko_fill

Set text via DOM (for contentEditable)

neko_press_key

Send keyboard key (Enter, Tab, etc.)

neko_get_state

Get page URL, title, interactive elements

neko_screenshot

Capture page screenshot

neko_scroll

Scroll page up/down

neko_go_back

Navigate back in history

neko_get_html

Get HTML of page or element

neko_list_tabs

List all open tabs

neko_switch_tab

Switch to tab by ID

neko_close_tab

Close tab by ID

neko_close

Close the browser

neko_upload_file

Upload files (direct input or dialog mode)

neko_evaluate

Execute JavaScript in page context

neko_select

Select dropdown option (by value/label/index)

neko_wait_for

Wait for selector state or navigation

neko_handle_dialog

Configure alert/confirm/prompt handling

neko_hover

Hover over element (tooltips, menus)

neko_check

Check/uncheck checkbox or radio

neko_double_click

Double-click element

neko_get_attribute

Get element attribute(s)

Installation

npm install
npm run build

Configuration

Environment variables:

Variable

Default

Description

NEKO_BROWSER_PROFILE

~/.neko-browser/profile

Profile directory path

NEKO_BROWSER_HEADLESS

false

Set to true for headless mode

Usage (MCP)

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "neko-browser": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/neko-browser"
    }
  }
}

License

MIT

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/aliksir/neko-browser'

If you have feedback or need assistance with the MCP directory API, please join our Discord server