uc-mcp-server

Un servidor MCP (Model Context Protocol) para interactuar programáticamente con el foro UnknownCheats. Omite la protección de Cloudflare utilizando una instancia real de Chrome y proporciona extracción de datos estructurados mediante Cheerio.

Características

• Omisión de Cloudflare — Utiliza puppeteer-real-browser con una instancia de Chrome con interfaz gráfica para resolver automáticamente los desafíos de Turnstile

• Persistencia de cookies — Las cookies de sesión se guardan en cookies.json y se reutilizan tras los reinicios

• Recuperación automática — Detecta errores de marco desconectado / bloqueo del navegador y se reinicia automáticamente

• 6 herramientas MCP — Inicio de sesión, búsqueda, lectura de hilos, paginación, extracción de código y depuración

Related MCP server: Ghost Browser MCP

Herramientas

Detalles de extract_code

Cuando se alcanza el límite, la respuesta incluye truncated: true, last_post_id (para que sepas dónde reanudar) y una pista sobre cuántos bloques se omitieron. Cada bloque también lleva un postId para que puedas rastrearlo hasta la publicación exacta en la página.

Stack

• Runtime: Bun

• Lenguaje: TypeScript (ESM)

• Protocolo: @modelcontextprotocol/sdk

• Navegador: puppeteer-real-browser

• Análisis: cheerio

Requisitos

• Bun v1.0+

• Google Chrome instalado (requerido por puppeteer-real-browser)

Instalación

# via npm
npx uc-mcp-server

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

Configuración con Claude Code

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

O con npx:

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

Configuración con Claude Desktop

Añadir a %APPDATA%\Claude\claude_desktop_config.json (Windows) o ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

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

Uso

En la primera ejecución, Chrome se abre en modo con interfaz gráfica. Inicia sesión manualmente o utiliza la herramienta login:

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

Las cookies se guardan automáticamente. Las ejecuciones posteriores reutilizan la sesión.

Ejemplos

# 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 })

Estructura del proyecto

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.)

Notas

• Todos los registros utilizan console.error() — console.log() está reservado para el transporte stdio de MCP

• La paginación de hilos está limitada a 50 páginas por defecto para fetch_all_pages

• La detección de lenguaje admite: C++, C#, Python, Lua

• Los archivos exportados se guardan en ./exports/ y están excluidos de git y npm

Problemas

¿Encontraste un error o quieres solicitar una función? Abre un problema en:

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