首先安装以下浏览器扩展：

• 捣碎猴
• Firefox 或 Chrome 版的 Tampermonkey 编辑器

然后全局安装tampermonkey-mcp：

最后，配置你的AI助手使用tampermonkey工具：

你的助手会拨打tampermonkey_get_connection_code，返回连接码，你可以在Tampermonkey Editors扩展中输入。

Claude Code 配置示例

建造

Tampermonkey MCP 服务器架构

概述

该项目实现了一个MCP（模型上下文协议）服务器，允许AI助手通过Tampermonkey Editors浏览器扩展读取和修改Tampermonkey用户脚本。

建筑组件

连接流

1. MCP 服务器启动 - 在随机可用端口创建 WebSocket 服务器
2. 生成连接代码 - 格式：
3. 用户呼叫tampermonkey_get_connection_code - 获取连接代码
4. 用户在Tampermonkey编辑器中输入代码 - 扩展解析代码以获取端口和认证
5. 扩展连接到MCP服务器 - WebSocket握手带认证
6. MCP 工具可用 - 现在可以调用列表、获取、补丁

认证协议

MCP工具

How to use

First install the following browser extensions:

• Tampermonkey
• Tampermonkey Editors for Firefox or Chrome

Then install tampermonkey-mcp globally:

npm install -g tampermonkey-mcp@latest

Finally configure your AI assistant to use the tampermonkey tool:

{
  "mcpServers": {
    "tampermonkey": {
      "command": "npx",
      "args": [
        "-y",
        "tampermonkey-mcp@latest"
      ]
    }
  }
}

Your assistant will call tampermonkey_get_connection_code and return a connection code that you can enter in the Tampermonkey Editors extension.

Claude Code configuration example

npm install -g @anthropic-ai/claude-code

// either use your local checkout
npm run watch
claude mcp add --transport http --scope project tampermonkey http://localhost:4001/mcp

// or the npm package
npm install -g tampermonkey-mcp@latest
claude mcp add --transport stdio --scope project tampermonkey -- npx -y tampermonkey-mcp

// more browser control needed?
// Open chrome://inspect/#remote-debugging
// [x] Allow remote debugging for this browser instance
// or
chromium --user-data-dir=/tmp/chrome-devtools-mcp-test-profile --remote-debugging-port=9222

npm install -g chrome-devtools-mcp@latest
// install Tampermonkey and Tampermonkey Editors
claude mcp add --transport stdio --scope project chrome-devtools-mcp -- npx -y chrome-devtools-mcp@latest --slim --no-usage-statistics --auto-connect --browser-url http://127.0.0.1:9222

Build

npm install
npm run all

Tampermonkey MCP Server Architecture

Overview

This project implements an MCP (Model Context Protocol) server that allows AI assistants to read and modify Tampermonkey userscripts via the Tampermonkey Editors browser extension.

Architecture Components

┌─────────────────────────────────────────────────────────────────────────────┐
│                              AI Assistant                                   │
└─────────────────────────────────────────────────────────────────────────────┘
                                   │
                                   │ MCP Protocol (stdio transport)
                                   ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                         tampermonkey_mcp (MCP Server)                       │
│                                                                             │
│  ┌───────────────────────────────────────────────────────────────────────┐  │
│  │  server.ts                    │  Main entry point                     │  │
│  │                               │  - HTTP or stdio transport            │  │
│  │                               │  - MCP middleware                     │  │
│  └───────────────────────────────────────────────────────────────────────┘  │