Сначала установите следующие расширения браузера: Тампермонейка Редакторы Tampermonkey для Firefox или Chrome

Затем установите tampermonkey-mcp глобально:

Наконец, настройте своего помощника ИИ, чтобы использовать инструмент tampermonkey:

Ваш помощник позвонит tampermonkey_get_connection_code и вернет код соединения, который вы можете ввести в расширение Tampermonkey Editors.

Пример конфигурации Claude Code

#построить

Архитектура сервера Tampermonkey MCP

Обзор

Этот проект реализует сервер MCP (Model Context Protocol), который позволяет помощникам ИИ читать и изменять пользовательские скрипты Tampermonkey через расширение браузера Tampermonkey Editors.

Архитектурные компоненты

##Связной поток

1. MCP Server Starts - Создает сервер WebSocket на случайно доступном порту 2.Сгенерированный код соединения - Формат: [[Т3]]
2. ** Пользователь звонит tampermonkey_get_connection_code** - Получает код соединения
3. ** Пользователь вводит код в редакторы Tampermonkey** - расширение парсирует код, чтобы получить порт и аут
4. ** Расширение подключается к MCP-серверу** - рукопожатие WebSocket с аутентификацией
5. ** Инструменты 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                     │  │
│  └───────────────────────────────────────────────────────────────────────┘  │