neko-browser
Headed Playwright browser MCP server with persistent profile, providing 23 tools for full browser automation while masking PII data.
README
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
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
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.