まず、次のブラウザ拡張機能をインストールします。 *タンパーモンキー

• FirefoxまたはChrome用のタンパーモンキーエディタ

tampermonkey-mcp をグローバルにインストールします。

最後に、AIアシスタントが[tampermonkeyツールを使用するように構成します。

アシスタントは [tampermonkey_get_connection_code を呼び出し、Tampermonkey Editors の拡張子に入力できる接続コードを返します。

Claude コード設定例

ビルド

Tampermonkey MCP Server アーキテクチャ

概要

このプロジェクトでは、AI アシスタントが Tampermonkey Editors ブラウザ拡張で Tampermonkey ユーザスクリプトを読み、変更できる MCP (Model Context Protocol) サーバを実装しています。

建築部品

接続フロー

1。MCP Serverが起動 - ランダムな利用可能なポートでWebSocketサーバーを作成 2.生成される接続コード - フォーマット:[ ] 3.ユーザーコール [tampermonkey_get_connection_code - 接続コードを取得する 4。ユーザーは、Tampermonkey Editorsでコードを入力する - ポートとauthを取得するには、コードを拡張 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                     │  │
│  └───────────────────────────────────────────────────────────────────────┘  │