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チャレンジを自動的に解決します

  • Cookieの永続化 — セッションCookieを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" })

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トランスポート用に予約されています

  • fetch_all_pages のスレッドページネーションはデフォルトで50ページに制限されています

  • 言語検出は C++, C#, Python, Lua をサポートしています

  • エクスポートされたファイルは ./exports/ に保存され、gitおよびnpmからは除外されます

問題

バグを見つけた場合や機能リクエストがある場合は、以下からIssueを作成してください:

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

Maintenance

ActivityMaintained
ResponsivenessSyncing

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