一个用于阅读和搜索UnknownCheats论坛的TypeScript MCP服务器。它使用Bun、本地Chrome窗口和Cheerio来解析论坛页面。

演示

https://github.com/user-attachments/assets/9f00f783-0a03-4e8d-b5b6-abd308936f20

安装

安装 Bun 和 Google Chrome。服务器使用 puppeteer-real-browser 和你已安装的浏览器;安装不会下载浏览器。如果 Chrome 不在标准位置，将 UC_CHROME_PATH 设置为绝对的 Chrome 或 Chromium 可执行路径。运行 npm 包时：

为了运行源代码：

服务器使用 MCP 而非标准输入输出。Chrome 在工具首次需要页面时打开。它在用户的应用数据目录（mcp-unknowncheat/chrome-profile）下保留专用配置文件，以便手动完成的浏览器挑战和登录在重启后能够存活。将 UC_PROFILE_DIR 设置为绝对路径以选择另一个配置文件;现有的 cookies.json 只有在配置文件首次创建时才会导入。在没有图形显示的 Linux 上，Chrome 运行无头模式;设置 UC_HEADLESS=1 在其他地方请求无头模式。如果出现 Cloudflare 挑战，请在可见的 Chrome 窗口中完成。

mcp-unknowncheat

A TypeScript MCP server for reading and searching the UnknownCheats forum. It uses Bun, a local Chrome window, and Cheerio to parse forum pages.

Demo

https://github.com/user-attachments/assets/9f00f783-0a03-4e8d-b5b6-abd308936f20

Install

Install Bun and Google Chrome. The server uses puppeteer-real-browser and your installed browser; installation does not download a browser. Set UC_CHROME_PATH to an absolute Chrome or Chromium executable path if Chrome is not in its standard location. Run the npm package with:

bunx mcp-unknowncheatz

To run the source:

git clone https://github.com/amangly/mcp-unknowncheat.git
cd mcp-unknowncheat
bun install --frozen-lockfile
bun run start

The server uses MCP over standard input and output. Chrome opens when a tool first needs a page. It keeps a dedicated profile under the user’s application data directory (mcp-unknowncheat/chrome-profile) so a manually completed browser challenge and login can survive restarts. Set UC_PROFILE_DIR to an absolute path to choose another profile; an existing cookies.json is imported only when the profile is first created. On Linux without a graphical display, Chrome runs headless; set UC_HEADLESS=1 to request headless mode elsewhere. If a Cloudflare challenge appears, complete it in the visible Chrome window. The server waits up to 45 seconds by default (UC_CF_WAIT_MS), subject to each tool’s time budget. Automated browsers are not guaranteed to pass production challenges. Clients may need a tool timeout over 60 seconds for first-time manual setup.

Connect an MCP client

Install Bun and Chrome first. Your MCP client starts the server with bunx mcp-unknowncheatz; you do not need to leave a separate terminal running. The examples below use the published npm package. To use a source checkout, replace bunx mcp-unknowncheatz with bun run /absolute/path/to/mcp-unknowncheat/src/index.ts.

Codex

Add the server from a terminal:

codex mcp add unknowncheat -- bunx mcp-unknowncheatz
codex mcp list

Or add this to ~/.codex/config.toml (on Windows, %USERPROFILE%\.codex\config.toml):

[mcp_servers.unknowncheat]
command = "bunx"
args = ["mcp-unknowncheatz"]
tool_timeout_sec = 120

Restart Codex after editing the config file.

Claude Code

claude mcp add --scope user unknowncheat -- bunx mcp-unknowncheatz
claude mcp list

Use --scope project if the server should be available only in one project.

Claude Desktop and Cursor

Add the server entry under mcpServers in the client’s JSON config. Claude Desktop uses %APPDATA%\Claude\claude_desktop_config.json on Windows or ~/Library/Application Support/Claude/claude_desktop_config.json on macOS. Cursor uses ~/.cursor/mcp.json for all projects or .cursor/mcp.json in one project.

{
  "mcpServers": {
    "unknowncheat": {
      "command": "bunx",