uc-mcp-server

Ein MCP-Server (Model Context Protocol) für die programmatische Interaktion mit dem UnknownCheats-Forum. Umgeht den Cloudflare-Schutz mithilfe einer echten Chrome-Instanz und bietet strukturierte Datenextraktion via Cheerio.

Funktionen

• Cloudflare-Umgehung — Nutzt puppeteer-real-browser mit einer sichtbaren Chrome-Instanz, um Turnstile-Herausforderungen automatisch zu lösen

• Cookie-Persistenz — Sitzungs-Cookies werden in cookies.json gespeichert und bei Neustarts wiederverwendet

• Automatische Wiederherstellung — Erkennt Fehler durch getrennte Frames/Browser-Abstürze und startet automatisch neu

• 6 MCP-Tools — Login, Suche, Thread-Lesen, Paginierung, Code-Extraktion und Debugging

Related MCP server: Ghost Browser MCP

Tools

Details zu extract_code

Wenn das Limit erreicht ist, enthält die Antwort truncated: true, last_post_id (damit Sie wissen, wo Sie fortfahren können) und einen Hinweis darauf, wie viele Blöcke übersprungen wurden. Jeder Block enthält zudem eine postId, sodass Sie ihn genau dem Beitrag auf der Seite zuordnen können.

Stack

• Laufzeit: Bun

• Sprache: TypeScript (ESM)

• Protokoll: @modelcontextprotocol/sdk

• Browser: puppeteer-real-browser

• Parsing: cheerio

Anforderungen

• Bun v1.0+

• Google Chrome installiert (erforderlich für puppeteer-real-browser)

Installation

# via npm
npx uc-mcp-server

# or clone
git clone https://github.com/amaralkaff/mcp-unknowncheat.git
cd mcp-unknowncheat
bun install

Einrichtung mit Claude Code

claude mcp add uc-mcp bun -- run "/path/to/mcp-unknowncheat/src/index.ts"

Oder mit npx:

claude mcp add uc-mcp npx -- uc-mcp-server

Einrichtung mit Claude Desktop

Hinzufügen zu %APPDATA%\Claude\claude_desktop_config.json (Windows) oder ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "uc-mcp": {
      "command": "npx",
      "args": ["uc-mcp-server"]
    }
  }
}

Verwendung

Beim ersten Start öffnet sich Chrome im sichtbaren Modus. Loggen Sie sich manuell ein oder verwenden Sie das login-Tool:

login({ username: "your_username", password: "your_password" })

Cookies werden automatisch gespeichert. Nachfolgende Ausführungen verwenden die Sitzung wieder.

Beispiele

# Check login status
check_login()

# Browse the Apex Legends subforum
search_forum({ subforum: "apex-legends" })

# Search across all forums
search_forum({ query: "pubg offsets" })

# Get a thread (single page)
get_thread({ url: "https://www.unknowncheats.me/forum/..." })

# Get all pages of a thread
get_thread({ url: "https://www.unknowncheats.me/forum/...", fetch_all_pages: true })

# Extract code blocks (up to 10 inline)
extract_code({ url: "https://www.unknowncheats.me/forum/..." })

# Extract all code blocks and save to file
extract_code({ url: "https://www.unknowncheats.me/forum/...", export_to_file: true })

Projektstruktur

src/
├── index.ts          # MCP server entry + tool registration
├── browser.ts        # Chrome lifecycle, Cloudflare bypass, cookie persistence
├── types.ts          # Shared TypeScript interfaces
├── tools/
│   ├── check-login.ts
│   ├── login.ts
│   ├── search-forum.ts
│   ├── get-thread.ts
│   ├── extract-code.ts
│   └── debug-page.ts
└── parsers/
    ├── thread.ts         # Post extraction, pagination
    ├── search-results.ts # Search result parsing
    ├── code-blocks.ts    # Code extraction + language detection
    └── tags.ts           # Thread tag detection ([Source], [Release], etc.)

Hinweise

• Alle Protokollierungen verwenden console.error() — console.log() ist für den MCP-stdio-Transport reserviert

• Die Thread-Paginierung ist standardmäßig auf 50 Seiten für fetch_all_pages begrenzt

• Die Spracherkennung unterstützt: C++, C#, Python, Lua

• Exportierte Dateien werden unter ./exports/ gespeichert und sind von git und npm ausgeschlossen

Probleme

Einen Fehler gefunden oder möchten Sie eine Funktion anfragen? Erstellen Sie ein Issue unter:

https://github.com/amaralkaff/mcp-unknowncheat/issues