Perfect
Allows controlling Chrome to search YouTube, open videos, and play media via browser automation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PerfectSearch Google for MCP servers and screenshot the results"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Not affiliated with Cursor, Anysphere, Google, or Anthropic. Unofficial community project.
Why I built this
Cursor is excellent in the repo. The moment I needed it in my real browser — same cookies, same session, forms, research, YouTube — I hit a wall. Cloud browser demos weren’t enough. I wanted the agent on my desk, in tabs I can see, with permissions I control and a Stop button that actually stops.
Perfect is that bridge: local MCP + Chrome extension, visible Perfect tab group, Manual by default, no Perfect cloud.
v0.2 — Linked bridge is stable · ~26 tools · live on the Chrome Web Store.
Related MCP server: Browserbeam MCP Server
Screenshots
Linked | Welcome / setup | Agent at work |
Quick start
Install the extension — Add to Chrome from the Chrome Web Store (recommended), or download the zip and Load unpacked.
Open Perfect → Copy setup prompt for Cursor.
Paste into Cursor — it merges MCP config (
npx -y perfect-mcp; GitHub fallback if npm isn’t published yet).Enable perfect in Settings → MCP → panel shows Linked.
Requires Node.js 20+ locally for the MCP server.
Try this prompt
Using Perfect: search YouTube for “Saiyaara song”, open the official YRF title track, and play it.
More recipes: Agent playbook
How it works
Cursor --MCP stdio--> perfect-mcp --localhost WS + token--> Chrome extension --CDP--> Perfect tab groupMode | Behavior |
Manual (default) | Approve actions |
Auto | Fewer prompts on trusted sites; protected still pauses |
Skip | Dangerous; prohibited actions still hard-block |
Tools (summary)
Area | Examples |
Tabs |
|
Read |
|
Act |
|
See |
|
Guard |
|
Full matrix + security model: Security · EVAL for Cursor
Develop
npm install && npm run build
npm test # Vitest unit + integration
npm run test:e2e # Playwright fixtures
npm run test:e2e:extension # Unpacked extension + MCP WS bridge
npm run pack:extension # → perfect-extension.zip (CWS / Load unpacked)Maker
Gobinda Tarafdar — WordPress product marketer · stubborn problem-solver · lifelong Harry Potter devotee.
By day: Product Marketing Specialist at WPBakery. Nights: workshop tools that scratch my own itches.
Site | |
X | |
GitHub | |
Donate |
If Perfect saves you time, a star or a small donation keeps the workshop lit.
Other projects from the workshop
Free, local-first where it counts.
Project | What it does |
Remembers how you signed in — never passwords or cookies | |
Copy folders between your Macs like Finder · MCP for AI IDEs | |
Free local Chrome toolkit for design, measure, and WordPress | |
Mac file manager with built-in editor | |
MCP bridge for Cursor and Claude | |
Lock your Mac, Slack goes AFK | |
Teammate local times inline in Slack | |
Find broken links without leaving the page | |
Documentation, conjured | |
A memory charm for what you forget online | |
AI video editor | |
Tech news, Daily Prophet style | |
Cost of living for 140+ countries |
Links
License
MIT © 2026 Gobinda Tarafdar
This server cannot be deployed
Maintenance
Related MCP Connectors
Browser MCP for logged-in tasks. Uses your Chrome — credentials stay local. Zero-token replay.
Real Chrome for agents: start a browser, read pages as numbered markdown, click, type, hand off.
Stealth web browser for agents: search, fetch, click, download and type in persistent MCP sessions.
Hyperbrowser MCP — wraps the Hyperbrowser AI-agent browsing API
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server + Chrome extension that gives AI coding agents control of your real browser with existing sessions, logins, and cookies. Works with Cursor, Claude, Windsurf.1883 npm50MIT
- AlicenseNot gradedqualityDmaintenanceEnables real browser automation as tools in Cursor, Claude Desktop, Windsurf, and any MCP-compatible client, allowing AI agents to interact with web pages through natural language.5 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to control Chrome browser actions like navigation, clicking, form filling, screenshots, and console/network logging via an MCP server and Chrome extension.532 npmMIT
- AlicenseNot gradedqualityCmaintenanceGives coding agents full control over a real Chrome browser, enabling navigation, clicking, typing, screenshotting, and more via an MCP server and Chrome extension.18 npm2MIT