MCPMonkey
About
MCPMonkey is an MCP server and Firefox extension so your AI agent can access your browser
Details
- License
- MIT license
Explore
MCPMonkey currently implements these key features:
- Tab Management (browserAction Tool):
- Get information about all open tabs
- Create new tabs
- Close tabs
- Activate (focus) tabs
- Duplicate tabs
- Page Style Extraction (getPageStyles Tool):
- Extract styling information from web pages for AI analysis
- Returns structured JSON data about styles
- Includes global styles, computed styles, color schemes, typography
- User Script Support: Full compatibility with existing userscripts (inherited from Violentmonkey)
The following features are planned for future development:
- MCP Server Management: Install and manage multiple MCP servers directly from your browser
- Enhanced Browser Access: Allow AI tools to interact with:
- Browsing history
- Bookmarks
- Dev console logs
- Other installed extensions
- Permissions Control: Fine-grained control over what resources each MCP server can access
- Community Hub: Share and discover MCP servers and scripts
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCPMonkeyCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
yarn
1. Build the project following the Development instructions below
2. Open Firefox and navigate to about:debugging
3. Click "This Firefox" in the left sidebar
4. Click "Load Temporary Add-on..."
5. Navigate to the dist folder in your MCPMonkey build directory
6. Select any file from the dist folder to load the extension
Note: As this is a temporary installation, you'll need to reload the extension each time you restart Firefox.
We plan on offering .xpi files soon.
###
Our implementation of MCP tools provides AI language models like those in Cursor with powerful browser interaction capabilities:
- browserAction Tool:
- Get information about all open tabs
- Create new tabs
- Close tabs
- Activate (focus) tabs
- Duplicate tabs
- getPageStyles Tool:
- Extract page styling information (global styles, computed styles, color schemes, typography)
- Returns structured JSON data for AI analysis
- Uses content script bridge for communication with web pages
These tools allow AI models to have meaningful, context-aware interactions with your browsing session through a WebSocket connection on port 3025.
For development and testing, you can run the server with the MCP inspector:
```sh
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcpmonkey": {
"MCPMonkey": {
"command": "node",
"args": [
"build/index.js"
]
}
}
}
}McpServers
{
"MCPMonkey": {
"command": "node",
"args": [
"build/index.js"
]
}
}MCPMonkey is a fork of Violentmonkey, extending its powerful userscript capabilities to support Model Context Protocol (MCP) servers. This project aims to bridge the gap between AI language models and browser interactions.
About MCPMonkey
MCPMonkey enhances the browser extension capabilities of Violentmonkey to provide a user-friendly interface for managing and using Model Context Protocol (MCP) servers. This allows AI language models like those used in Cursor to interact with your browser in meaningful ways.
Current Features
MCPMonkey currently implements these key features:
- Tab Management (browserAction Tool):
- Get information about all open tabs
- Create new tabs
- Close tabs
- Activate (focus) tabs
- Duplicate tabs
- Page Style Extraction (getPageStyles Tool):
- Extract styling information from web pages for AI analysis
- Returns structured JSON data about styles
- Includes global styles, computed styles, color schemes, typography
- User Script Support: Full compatibility with existing userscripts (inherited from Violentmonkey)
Planned Features
The following features are planned for future development:
- MCP Server Management: Install and manage multiple MCP servers directly from your browser
- Enhanced Browser Access: Allow AI tools to interact with:
- Browsing history
- Bookmarks
- Dev console logs
- Other installed extensions
- Permissions Control: Fine-grained control over what resources each MCP server can access
- Community Hub: Share and discover MCP servers and scripts
Cursor MCP Integration
MCPMonkey consists of two main components that need to be installed in the following order:
1. MCP Server
2. Browser Extension
1. Adding the MCP Server to Cursor
Using the published NPM package:
- In Cursor, go to Settings > Features > MCP Servers
- Click the + Add New MCP Server button
- Configure the connection with:
- Name: mcpmonkey-server
- Type: command
- Command: npx mcpmonkey-server
Or if building yourself:
```sh
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
