MCPMonkey

Name: MCPMonkey
Author: kstrikis

@kstrikis

Repository

About MCPMonkey

MCPMonkey is an MCP server and Firefox extension so your AI agent can access your browser

#mcpmonkey #browser-extension #ai-integration

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "MCPMonkey": {
      "command": "node",
      "args": [
        "build/index.js"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCPMonkey?

MCPMonkey is a fork of Violentmonkey that extends its userscript capabilities to support Model Context Protocol (MCP) servers. It bridges AI language models (such as those used in Cursor) with browser interactions, providing tools for tab management and page style extraction.

How to use MCPMonkey?

Install two components: the MCP server and the browser extension. In Cursor, add the MCP server via Settings > Features > MCP Servers with the command npx mcpmonkey-server. Install the browser extension by building from source and loading it as a temporary add-on in Firefox (.xpi files are planned).

Key features of MCPMonkey

Tab management: get info, create, close, activate, and duplicate tabs.
Page style extraction: extract global styles, computed styles, color schemes, typography.
Full compatibility with existing Violentmonkey userscripts.
Planned MCP server management and installation from the browser.
Planned fine-grained permissions control over MCP server resources.
Uses WebSocket (port 3025) internally and stdio transport for external MCP clients.

Use cases of MCPMonkey

Developers can access browser resources directly from Cursor or other AI tools.
Users can let a desktop chatbot help find a previously visited website.
AI tools can draft social media posts or emails based on browser context.
Automate browser interactions through natural language commands.

FAQ from MCPMonkey

What is the difference between MCPMonkey and Violentmonkey?

MCPMonkey extends Violentmonkey to support MCP servers, allowing AI language models to control browser tabs and extract page styles via MCP tools.

What are the runtime requirements for MCPMonkey?

You need Node.js (version matching package.json) and Yarn v1.x to build the extension. The browser extension currently supports Firefox as a temporary add-on; a compatible MCP client like Cursor is required for the server.

How does MCPMonkey communicate?

The MCP server uses stdio transport for external clients (e.g., Cursor) and a WebSocket server on port 3025 for internal communication with the browser extension.

What data can MCPMonkey access?

Currently it can read open tabs and page styles. Planned features include access to browsing history, bookmarks, dev console logs, and other extensions, with permission controls.

Is MCPMonkey production-ready?

The browser extension is in development and only available as a temporary Firefox add-on. Planned releases include .xpi files and a community hub for MCP servers and scripts.