mcp-unknowncheatz 0.3.0 → 0.3.2

package/src/tools/get-thread.ts

@@ -1,7 +1,9 @@
+import { withBrowserSession } from "../browser.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { fetchHtml } from "../crawl.js";
 import { parseThread } from "../parsers/thread.js";
+import { getForumIndex } from "../forum-index.js";
 import type { ThreadPost } from "../types.js";
 
 const MAX_PAGES = 50;
@@ -13,11 +15,11 @@ function buildPageUrl(baseUrl: string, page: number): string {
   return url.toString();
 }
 
-async function fetchImageAsBase64(url: string): Promise<{ data: string; mimeType: string } | null> {
+async function fetchImageAsBase64(url: string, deadlineAt: number): Promise<{ data: string; mimeType: string } | null> {
   try {
     const res = await fetch(url, {
       headers: { "User-Agent": "Mozilla/5.0" },
-      signal: AbortSignal.timeout(8_000),
+      signal: AbortSignal.timeout(Math.max(1, Math.min(8_000, deadlineAt - Date.now()))),
     });
     if (!res.ok) return null;
 
@@ -36,7 +38,7 @@ async function fetchImageAsBase64(url: string): Promise<{ data: string; mimeType
 export function registerGetThread(server: McpServer): void {
   server.tool(
     "get_thread",
-    "Get a forum thread. Use latest_pages for recent posts in long-running threads; the default reads only the linked page.",
+    "Read the source UnknownCheats thread behind a game hacking or offset claim. Use latest_pages for recent posts in long-running threads; the default reads only the linked page.",
     {
       url: z.string().url().describe("Thread URL"),
       fetch_all_pages: z
@@ -57,9 +59,11 @@ export function registerGetThread(server: McpServer): void {
         .default(false)
         .describe("If true, fetches post images and returns them as viewable image content (max 10 images)"),
     },
-    async ({ url, fetch_all_pages, latest_pages, include_images }) => {
+    { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
+    async ({ url, fetch_all_pages, latest_pages, include_images }) => withBrowserSession(async () => {
       try {
-        const firstHtml = await fetchHtml(url);
+        const deadlineAt = Date.now() + 45_000;
+        const firstHtml = await fetchHtml(url, { deadlineAt });
         const pageParam = Number(new URL(url).searchParams.get("page"));
         const requestedPage = Number.isInteger(pageParam) && pageParam > 0 ? pageParam : 1;
         const firstPage = parseThread(firstHtml, url, requestedPage);
@@ -72,20 +76,42 @@ export function registerGetThread(server: McpServer): void {
             : [Math.min(requestedPage, totalPages)];
 
         const allPosts: ThreadPost[] = [];
+        const pagesFetched: number[] = [];
+        let timeBudgetReached = false;
         for (const pageNum of pagesToFetch) {
+          if (pageNum !== requestedPage && Date.now() >= deadlineAt) {
+            timeBudgetReached = true;
+            break;
+          }
           const pageUrl = buildPageUrl(url, pageNum);
-          const html = pageNum === requestedPage ? firstHtml : await fetchHtml(pageUrl);
-          allPosts.push(...parseThread(html, pageUrl, pageNum).posts);
+          let html: string;
+          try {
+            html = pageNum === requestedPage ? firstHtml : await fetchHtml(pageUrl, { deadlineAt });
+          } catch (error) {
+            if (Date.now() < deadlineAt) throw error;
+            timeBudgetReached = true;
+            break;
+          }
+          const parsed = parseThread(html, pageUrl, pageNum);
+          allPosts.push(...parsed.posts);
+          getForumIndex().recordThreadPage(parsed, pageNum);
+          pagesFetched.push(pageNum);
           console.error(`[get-thread] Fetched page ${pageNum}/${totalPages}`);
         }
+        if (pagesFetched.length === 0 && firstPage.posts.length > 0) {
+          allPosts.push(...firstPage.posts);
+          pagesFetched.push(requestedPage);
+          getForumIndex().recordThreadPage(firstPage, requestedPage);
+        }
 
         const result = {
           title: firstPage.title,
           posts: allPosts,
-          currentPage: pagesToFetch.at(-1),
-          pagesFetched: pagesToFetch,
+          currentPage: pagesFetched.at(-1),
+          pagesFetched,
           totalPages,
           url,
+          timeBudgetReached,
           ...(fetch_all_pages && !latest_pages && totalPages > MAX_PAGES
             ? { note: `Capped at ${MAX_PAGES} pages (thread has ${totalPages} total)` }
             : {}),
@@ -95,7 +121,7 @@ export function registerGetThread(server: McpServer): void {
         const content: Array<
           | { type: "text"; text: string }
           | { type: "image"; data: string; mimeType: string }
-        > = [{ type: "text", text: JSON.stringify(result) }];
+        > = [];
 
         if (include_images) {
           // Collect all unique image URLs from all posts
@@ -116,7 +142,11 @@ export function registerGetThread(server: McpServer): void {
           console.error(`[get-thread] Fetching ${imageUrls.length} images...`);
 
           for (const imgUrl of imageUrls) {
-            const img = await fetchImageAsBase64(imgUrl);
+            if (Date.now() >= deadlineAt) {
+              result.timeBudgetReached = true;
+              break;
+            }
+            const img = await fetchImageAsBase64(imgUrl, deadlineAt);
             if (img) {
               content.push({ type: "image", data: img.data, mimeType: img.mimeType });
               console.error(`[get-thread] Fetched image: ${imgUrl}`);
@@ -124,6 +154,9 @@ export function registerGetThread(server: McpServer): void {
           }
         }
 
+        if (include_images && Date.now() >= deadlineAt) result.timeBudgetReached = true;
+        content.unshift({ type: "text", text: JSON.stringify(result) });
+
         return { content };
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
@@ -132,6 +165,6 @@ export function registerGetThread(server: McpServer): void {
           isError: true,
         };
       }
-    }
+    })
   );
 }

package/src/tools/get-user-reputation.ts

@@ -1,3 +1,4 @@
+import { withBrowserSession } from "../browser.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { load } from "cheerio";
@@ -32,7 +33,7 @@ export function registerGetUserReputation(server: McpServer): void {
         .optional()
         .describe("Numeric UC user ID (alternative to profile_url)"),
     },
-    async ({ profile_url, user_id }) => {
+    async ({ profile_url, user_id }) => withBrowserSession(async () => {
       try {
         const url = profile_url ?? (user_id
           ? `https://www.unknowncheats.me/forum/members/${user_id}.html`
@@ -120,6 +121,6 @@ export function registerGetUserReputation(server: McpServer): void {
           isError: true,
         };
       }
-    }
+    })
   );
 }

package/src/tools/list-subforums.ts

@@ -1,3 +1,4 @@
+import { withBrowserSession } from "../browser.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { fetchHtml } from "../crawl.js";
@@ -12,7 +13,7 @@ export function registerListSubforums(server: McpServer): void {
       limit: z.number().int().min(1).max(500).optional().default(100).describe("Max subforums returned (default 100)"),
       refresh: z.boolean().optional().default(false).describe("Fetch the forum index again instead of using the local directory"),
     },
-    async ({ query, limit, refresh }) => {
+    async ({ query, limit, refresh }) => withBrowserSession(async () => {
       try {
         const cached = refresh ? null : await readForumCatalog();
         const catalog = cached ?? await saveForumCatalog(await fetchHtml(FORUM_INDEX, { bypassCache: refresh }));
@@ -54,6 +55,6 @@ export function registerListSubforums(server: McpServer): void {
           isError: true,
         };
       }
-    }
+    })
   );
 }

package/src/tools/login.ts

@@ -1,3 +1,4 @@
+import { withBrowserSession } from "../browser.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { load } from "cheerio";
@@ -15,7 +16,7 @@ export function registerLogin(server: McpServer): void {
       username: z.string().describe("UnknownCheats username"),
       password: z.string().describe("UnknownCheats password"),
     },
-    async ({ username, password }) => {
+    async ({ username, password }) => withBrowserSession(async () => {
       try {
         const { page } = await navigateWithRetry(UC_LOGIN);
 
@@ -66,6 +67,6 @@ export function registerLogin(server: McpServer): void {
           isError: true,
         };
       }
-    }
+    })
   );
 }

package/src/tools/search-forum.ts

@@ -1,3 +1,4 @@
+import { withBrowserSession } from "../browser.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { load } from "cheerio";
@@ -6,13 +7,24 @@ import { fetchHtml } from "../crawl.js";
 import { isLoggedIn } from "../auth.js";
 import { searchViaSubforums } from "../search-fallback.js";
 import { filterThreads, parseThreadList } from "../parsers/thread-list.js";
+import { FORUM_INDEX, readForumCatalog, saveForumCatalog } from "../forum-catalog.js";
+import { getForumIndex } from "../forum-index.js";
 
 const UC_HOME = "https://www.unknowncheats.me/forum/";
 const UC_SEARCH = "https://www.unknowncheats.me/forum/search.php";
 
 async function runFallbackSearch(query: string) {
   console.error(`[search] Not logged in — scanning UC subforums for "${query}"`);
-  const { results, scannedSubforums } = await searchViaSubforums(query, (url) => fetchHtml(url));
+  const catalog = await readForumCatalog() ?? await saveForumCatalog(await fetchHtml(FORUM_INDEX));
+  const { results, scannedSubforums } = await searchViaSubforums(query, async (url) => {
+    const html = await fetchHtml(url);
+    const slug = new URL(url).pathname.match(/^\/forum\/([a-z0-9-]+)\/$/)?.[1];
+    if (slug) {
+      const entries = parseThreadList(html);
+      if (entries.length > 0) getForumIndex().recordListing(slug, 1, entries);
+    }
+    return html;
+  }, catalog.subforums);
 
   return {
     count: results.length,
@@ -29,7 +41,7 @@ async function runFallbackSearch(query: string) {
 export function registerSearchForum(server: McpServer): void {
   server.tool(
     "search_forum",
-    "Search the UnknownCheats forum. Uses advanced search when logged in, scans relevant subforums as a guest, or browses a named subforum.",
+    "Use for live UnknownCheats evidence when a user asks about game hacking, cheats, anti-cheat, reversing, offsets, or a forum thread. Uses advanced search when logged in, scans relevant subforums as a guest, or browses a named subforum.",
     {
       query: z.string().optional().default("").describe("Search query string; optional when browsing a subforum"),
       subforum: z.string().optional().describe("Subforum slug to browse directly (e.g. 'apex-legends')"),
@@ -37,7 +49,8 @@ export function registerSearchForum(server: McpServer): void {
       sort_by: z.enum(["relevancy", "lastpost", "replycount", "views", "threadstart"]).optional().default("relevancy").describe("Sort results by"),
       search_user: z.string().optional().describe("Filter by thread author username"),
     },
-    async ({ query, subforum, title_only, sort_by, search_user }) => {
+    { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
+    async ({ query, subforum, title_only, sort_by, search_user }) => withBrowserSession(async () => {
       try {
         if (!subforum && !query.trim()) {
           return {
@@ -49,7 +62,9 @@ export function registerSearchForum(server: McpServer): void {
         if (subforum) {
           const url = `https://www.unknowncheats.me/forum/${subforum}/`;
           const html = await fetchHtml(url);
-          const results = filterThreads(parseThreadList(html), { query, includeSticky: true });
+          const entries = parseThreadList(html);
+          if (entries.length > 0) getForumIndex().recordListing(subforum, 1, entries);
+          const results = filterThreads(entries, { query, includeSticky: true });
           return {
             content: [{ type: "text", text: JSON.stringify({ count: results.length, subforum, results }) }],
           };
@@ -107,6 +122,7 @@ export function registerSearchForum(server: McpServer): void {
 
         const html = await page.content();
         const results = parseThreadList(html);
+        if (results.length > 0) getForumIndex().recordSearchResults(results);
         const $ = load(html);
         const pageTitle = $("title").text().trim();
 
@@ -141,6 +157,6 @@ export function registerSearchForum(server: McpServer): void {
           };
         }
       }
-    }
+    })
   );
 }