uc-mcp-server

Сервер MCP (Model Context Protocol) для программного взаимодействия с форумом UnknownCheats. Обходит защиту Cloudflare с помощью реального экземпляра Chrome и обеспечивает структурированное извлечение данных через Cheerio.

Возможности

• Обход Cloudflare — использует puppeteer-real-browser с графическим экземпляром Chrome для автоматического решения задач Turnstile

• Сохранение cookie — сессионные cookie сохраняются в cookies.json и повторно используются после перезапуска

• Автовосстановление — обнаруживает ошибки отсоединения фрейма или сбоя браузера и автоматически перезапускается

• 6 инструментов MCP — вход, поиск, чтение тем, пагинация, извлечение кода и отладка

Related MCP server: Ghost Browser MCP

Инструменты

Подробности extract_code

При достижении лимита ответ включает truncated: true, last_post_id (чтобы вы знали, откуда продолжить) и подсказку о том, сколько блоков было пропущено. Каждый блок также содержит postId, чтобы вы могли отследить его до конкретного сообщения на странице.

Стек

• Среда выполнения: Bun

• Язык: TypeScript (ESM)

• Протокол: @modelcontextprotocol/sdk

• Браузер: puppeteer-real-browser

• Парсинг: cheerio

Требования

• Bun v1.0+

• Установленный Google Chrome (требуется для puppeteer-real-browser)

Установка

# via npm
npx uc-mcp-server

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

Настройка с Claude Code

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

Или через npx:

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

Настройка с Claude Desktop

Добавьте в %APPDATA%\Claude\claude_desktop_config.json (Windows) или ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

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

Использование

При первом запуске Chrome открывается в графическом режиме. Войдите вручную или используйте инструмент login:

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

Cookie сохраняются автоматически. Последующие запуски используют сессию повторно.

Примеры

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

Структура проекта

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

Примечания

• Все логирование использует console.error() — console.log() зарезервирован для транспорта MCP stdio

• Пагинация тем ограничена 50 страницами по умолчанию для fetch_all_pages

• Поддержка определения языков: C++, C#, Python, Lua

• Экспортируемые файлы сохраняются в ./exports/ и исключены из git и npm

Проблемы

Нашли ошибку или хотите предложить функцию? Создайте issue здесь:

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