Skip to main content
Glama
amaralkaff

UnknownCheats MCP

by amaralkaff

uc-mcp-server

UnknownCheats 포럼과 프로그래밍 방식으로 상호 작용하기 위한 MCP(Model Context Protocol) 서버입니다. 실제 Chrome 인스턴스를 사용하여 Cloudflare 보호를 우회하고 Cheerio를 통해 구조화된 데이터 추출을 제공합니다.

npm version License: MIT

기능

  • Cloudflare 우회 — puppeteer-real-browser와 헤드형 Chrome 인스턴스를 사용하여 Turnstile 챌린지를 자동으로 해결합니다.

  • 쿠키 지속성 — 세션 쿠키가 cookies.json에 저장되며 재시작 시에도 재사용됩니다.

  • 자동 복구 — 분리된 프레임/브라우저 충돌 오류를 감지하고 자동으로 다시 시작합니다.

  • 6가지 MCP 도구 — 로그인, 검색, 스레드 읽기, 페이지 매김, 코드 추출 및 디버그

Related MCP server: Ghost Browser MCP

도구

도구

설명

매개변수

check_login

브라우저 세션이 로그인되어 있는지 확인

—

login

자격 증명을 자동 입력하고 로그인

username, password

search_forum

UC 검색 또는 하위 포럼 탐색

query, subforum?

get_thread

페이지 매김을 사용하여 스레드 게시물 가져오기

url, fetch_all_pages?

extract_code

C++/C#/Python/Lua 코드 블록 추출

url, limit?, export_to_file?

debug_page

디버깅을 위해 원시 페이지 구조 검사

url

extract_code 세부 정보

매개변수

기본값

설명

url

필수

스레드 URL

limit

10 (최대 50)

인라인으로 반환할 최대 블록 수

export_to_file

false

모든 블록을 exports/<slug>_<timestamp>.json에 저장

제한에 도달하면 응답에는 truncated: true, last_post_id(재개 위치를 알 수 있도록), 건너뛴 블록 수에 대한 힌트가 포함됩니다. 각 블록에는 페이지의 정확한 게시물로 추적할 수 있도록 postId도 포함되어 있습니다.

스택

요구 사항

  • 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" })

쿠키는 자동으로 저장됩니다. 이후 실행 시 세션이 재사용됩니다.

예시

# 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 전송을 위해 예약되어 있습니다.

  • 스레드 페이지 매김은 fetch_all_pages의 경우 기본적으로 50페이지로 제한됩니다.

  • 언어 감지는 C++, C#, Python, Lua를 지원합니다.

  • 내보낸 파일은 ./exports/에 저장되며 git 및 npm에서 제외됩니다.

문제

버그를 발견했거나 기능을 요청하고 싶으신가요? 다음 링크에서 이슈를 생성하세요:

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Fetches content from authenticated web pages by driving your signed-in Chrome/Edge browser via DevTools Protocol, automatically handling login redirects and reusing sessions across domains.
    9
    MIT
  • -
    license
    Not graded
    quality
    Not graded
    maintenance
    Undetectable browser automation server for MCP-compatible AI agents, offering 225 tools across 32 sections to navigate, extract, clone pages, and bypass antibot systems like Cloudflare.
    1
    -
  • A
    license
    A
    quality
    F
    maintenance
    A stealth browser automation MCP server that wraps CloakBrowser's patched Chromium to bypass bot detection, providing 22 tools for web navigation, interaction, and session management.
    24
    2
    MIT