먼저 다음 브라우저 확장을 설치:

• 타깃키
• Firefox 또는 Chrome용 Tampermonkey 편집기

다음을 설치 tampermonkey-mcp 전 세계:

마지막으로 AI Assistant를 구성 tampermonkey 도구:

여러분의 조수는 tampermonkey_get_connection_code 을 호출하고 Tampermonkey Editors extension에 입력할 수 있는 연결 코드를 반환합니다.

Claude Code 구성 예

구조

Tampermonkey MCP 서버 아키텍처

개요

이 프로젝트는 Tampermonkey Editors 브라우저 확장을 통해 Tampermonkey userscripts를 읽고 수정할 수 있는 MCP(Model Context Protocol) 서버를 구현합니다.

건축 성분

연결 교류

1. MCP Server start - 임의 사용 가능한 포트에 WebSocket 서버를 만듭니다. 2.연결 코드 생성 - 형식:
2. User 호출 tampermonkey_get_connection_code - 연결 코드를 가져옵니다 4.User는 Tampermonkey Editors의 코드를 입력합니다. - 포트와 우스를 얻기 위한 확장 파일
3. ** 연장은 MCP 서버**에 연결됩니다. - WebSocket의 인증
4. ** 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                     │  │
│  └───────────────────────────────────────────────────────────────────────┘  │