foolfuuka-mcp-server 0.1.0

package/README.md

@@ -0,0 +1,127 @@
+# foolfuuka-mcp-server
+
+MCP server for querying 4chan archives (Desuarchive, 4plebs, b4k, archived.moe) via the [FoolFuuka](https://github.com/FoolCode/FoolFuuka) API. Enables AI agents to search and retrieve historical archived posts through the [Model Context Protocol](https://modelcontextprotocol.io).
+
+## Quick start
+
+```sh
+# Run directly (no install needed)
+npx foolfuuka-mcp-server
+
+# Or install globally
+npm install -g foolfuuka-mcp-server
+foolfuuka-mcp-server
+```
+
+Add to your MCP client config (Claude Desktop, VS Code, etc.):
+
+```json
+{
+  "mcpServers": {
+    "foolfuuka": {
+      "command": "npx",
+      "args": ["foolfuuka-mcp-server"]
+    }
+  }
+}
+```
+
+## Configuration
+
+| Environment variable | Default | Description |
+|---|---|---|
+| `FOOLFUUKA_BASE_URL` | `https://desuarchive.org` | Root URL of a FoolFuuka archive |
+| `FOOLFUUKA_USER_AGENT` | `foolfuuka-mcp-server/1.0` | User-Agent header sent with API requests |
+
+> [!TIP]
+> Desuarchive works out of the box. For Cloudflare-protected archives (4plebs, archived.moe), you may need to run the server on a machine with the archive whitelisted, or use a different base URL.
+
+## Tools
+
+### `search_archive`
+
+Full-text search across archived posts with filters.
+
+**Parameters:** `text`, `boards`, `subject`, `username`, `tripcode`, `capcode`, `filename`, `image`, `uid`, `country`, `deleted`, `ghost`, `filter`, `type`, `start`, `end`, `results`, `order`, `page`
+
+Returns a markdown table of matching posts with excerpts.
+
+### `get_thread`
+
+Retrieve all posts in a thread.
+
+**Parameters:** `board`, `num`, `latest_doc_id` (incremental), `last_limit` (default 100)
+
+Returns the OP post and all replies in markdown with author, timestamp, content, and media.
+
+### `get_post`
+
+Retrieve a single post.
+
+**Parameters:** `board`, `num` (supports `_` suffix for ghost posts)
+
+Returns full post details including media link when present.
+
+### `list_boards`
+
+List available boards for the configured archive.
+
+**Parameters:** none
+
+Returns a markdown table of board shortnames and names.
+
+## Examples
+
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "tools/call",
+  "params": {
+    "name": "search_archive",
+    "arguments": { "boards": "a", "text": "hello world", "page": 1 }
+  }
+}
+```
+
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 2,
+  "method": "tools/call",
+  "params": {
+    "name": "get_thread",
+    "arguments": { "board": "a", "num": 112800651 }
+  }
+}
+```
+
+## How it works
+
+The server runs over **stdio transport** — it reads JSON-RPC messages from stdin and writes responses to stdout. There is no HTTP server.
+
+```
+LLM  <--MCP stdio-->  foolfuuka-mcp-server  <--HTTP-->  FoolFuuka Archive
+```
+
+All responses are formatted as markdown rather than raw JSON, making them natural for LLMs to consume without extra parsing.
+
+## Rate limits
+
+FoolFuuka archives enforce rate limits (e.g., ~5 requests/minute on 4plebs). The server respects `Retry-After` headers on 429 responses and surfaces the wait time to the caller.
+
+## Development
+
+```sh
+git clone https://github.com/dynmie/foolfuuka-mcp-server.git
+cd foolfuuka-mcp-server
+npm install
+npm run build
+npm test
+```
+
+Tests are written with [Vitest](https://vitest.dev) and live in `tests/`.
+
+## License
+
+MIT

package/dist/foolfuuka.d.ts

@@ -0,0 +1,31 @@
+import type { Post, SearchParams } from "./types.js";
+export declare function searchPosts(params: SearchParams): Promise<{
+    posts: Post[];
+    meta?: {
+        total_found: number;
+        max_results: number;
+    };
+}>;
+export declare function getThread(board: string, num: number, latest_doc_id?: number, last_limit?: number): Promise<{
+    op: Post;
+    posts: Record<string, Post>;
+}>;
+export declare function getPost(board: string, num: string): Promise<Post>;
+export declare function listBoards(): Promise<{
+    site: {
+        url: string;
+        name: string;
+        title: string;
+        global_search_enabled: boolean;
+    };
+    boards: Array<{
+        shortname: string;
+        name: string;
+        search_enabled: boolean;
+    }>;
+}>;
+export declare function parseGhostNum(num: string): {
+    postNum: string;
+    subnum: string;
+};
+//# sourceMappingURL=foolfuuka.d.ts.map

package/dist/foolfuuka.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foolfuuka.d.ts","sourceRoot":"","sources":["../src/foolfuuka.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,IAAI,EACJ,YAAY,EACb,MAAM,YAAY,CAAC;AA0DpB,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC,CAmBvI;AAED,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,aAAa,CAAC,EAAE,MAAM,EACtB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;CAAE,CAAC,CAWpD;AAED,wBAAsB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvE;AAgFD,wBAAsB,UAAU,IAAI,OAAO,CAAC;IAC1C,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,qBAAqB,EAAE,OAAO,CAAA;KAAE,CAAC;IACnF,MAAM,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC7E,CAAC,CAiBD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAG9E"}

package/dist/foolfuuka.js

@@ -0,0 +1,179 @@
+function getBaseUrl() {
+    return process.env.FOOLFUUKA_BASE_URL || "https://desuarchive.org";
+}
+function getUserAgent() {
+    return process.env.FOOLFUUKA_USER_AGENT || "foolfuuka-mcp-server/1.0";
+}
+function buildUrl(path, params) {
+    const base = getBaseUrl().replace(/\/+$/, "");
+    const url = new URL(`${base}/_/api/chan${path}`);
+    if (params) {
+        for (const [key, value] of Object.entries(params)) {
+            if (value !== undefined && value !== null) {
+                url.searchParams.set(key, String(value));
+            }
+        }
+    }
+    return url.toString();
+}
+async function apiFetch(url) {
+    const res = await fetch(url, {
+        headers: { "User-Agent": getUserAgent() },
+    });
+    if (res.status === 429) {
+        const retryAfter = res.headers.get("Retry-After");
+        const msg = retryAfter
+            ? `Rate limited. Retry after ${retryAfter} seconds.`
+            : "Rate limited. Try again later.";
+        throw new Error(msg);
+    }
+    if (res.status === 204) {
+        return null;
+    }
+    if (!res.ok) {
+        let detail = res.statusText;
+        try {
+            const errBody = await res.json();
+            if (errBody?.error)
+                detail = String(errBody.error);
+        }
+        catch { /* ignore parse failures */ }
+        throw new Error(`HTTP ${res.status}: ${detail}`);
+    }
+    const body = await res.json();
+    if (body && typeof body === "object" && "error" in body) {
+        throw new Error(String(body.error));
+    }
+    return body;
+}
+export async function searchPosts(params) {
+    const queryParams = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined) {
+            queryParams[key] = value;
+        }
+    }
+    const url = buildUrl("/search/", queryParams);
+    const body = await apiFetch(url);
+    if (!body)
+        return { posts: [], meta: { total_found: 0, max_results: 0 } };
+    const posts = body["0"]?.posts ?? [];
+    const meta = body.meta
+        ? { total_found: body.meta.total_found, max_results: body.meta.max_results }
+        : undefined;
+    return { posts, meta };
+}
+export async function getThread(board, num, latest_doc_id, last_limit) {
+    const url = buildUrl("/thread/", { board, num, latest_doc_id, last_limit });
+    const body = await apiFetch(url);
+    if (!body)
+        return { op: {}, posts: {} };
+    const threadKey = String(num);
+    const thread = body[threadKey];
+    if (!thread)
+        throw new Error("Thread not found.");
+    return { op: thread.op, posts: thread.posts };
+}
+export async function getPost(board, num) {
+    const url = buildUrl("/post/", { board, num });
+    const body = await apiFetch(url);
+    return body;
+}
+const FOURCHAN_BOARDS = [
+    { shortname: "a", name: "Anime & Manga" },
+    { shortname: "b", name: "Random" },
+    { shortname: "c", name: "Anime/Cute" },
+    { shortname: "d", name: "Hentai/Alternative" },
+    { shortname: "e", name: "Mecha" },
+    { shortname: "f", name: "Flash" },
+    { shortname: "g", name: "Technology" },
+    { shortname: "gif", name: "GIF" },
+    { shortname: "h", name: "Hentai" },
+    { shortname: "hr", name: "High Resolution" },
+    { shortname: "k", name: "Weapons" },
+    { shortname: "m", name: "Mecha" },
+    { shortname: "o", name: "Auto" },
+    { shortname: "p", name: "Photography" },
+    { shortname: "s", name: "Sexy Beautiful Women" },
+    { shortname: "t", name: "Torrents" },
+    { shortname: "u", name: "Yuri" },
+    { shortname: "v", name: "Video Games" },
+    { shortname: "vg", name: "Video Game Generals" },
+    { shortname: "vm", name: "Video Games/Mecha" },
+    { shortname: "vmg", name: "Video Games/Mobile" },
+    { shortname: "vr", name: "Retro Games" },
+    { shortname: "vrpg", name: "Video Games/RPG" },
+    { shortname: "vst", name: "Video Games/Strategy" },
+    { shortname: "w", name: "Wallpapers" },
+    { shortname: "wg", name: "Wallpapers/General" },
+    { shortname: "i", name: "Oekaki" },
+    { shortname: "ic", name: "Artwork/Critique" },
+    { shortname: "r9k", name: "ROBOT9001" },
+    { shortname: "s4s", name: "Shit 4chan Says" },
+    { shortname: "vip", name: "Very Important Posts" },
+    { shortname: "cm", name: "Cute/Male" },
+    { shortname: "hm", name: "Handsome Men" },
+    { shortname: "lgbt", name: "LGBT" },
+    { shortname: "y", name: "Yaoi" },
+    { shortname: "3", name: "3DCG" },
+    { shortname: "aco", name: "Adult Cartoons" },
+    { shortname: "adv", name: "Advice" },
+    { shortname: "an", name: "Animals & Nature" },
+    { shortname: "bant", name: "Banned" },
+    { shortname: "biz", name: "Business & Finance" },
+    { shortname: "cgl", name: "Cosplay & EGL" },
+    { shortname: "ck", name: "Food & Cooking" },
+    { shortname: "co", name: "Comics & Cartoons" },
+    { shortname: "diy", name: "Do It Yourself" },
+    { shortname: "fa", name: "Fashion" },
+    { shortname: "fit", name: "Fitness" },
+    { shortname: "gd", name: "Graphic Design" },
+    { shortname: "hc", name: "Hardcore" },
+    { shortname: "his", name: "History & Humanities" },
+    { shortname: "int", name: "International" },
+    { shortname: "jp", name: "Otaku Culture" },
+    { shortname: "lit", name: "Literature" },
+    { shortname: "mlp", name: "My Little Pony" },
+    { shortname: "mu", name: "Music" },
+    { shortname: "n", name: "Transportation" },
+    { shortname: "news", name: "Current News" },
+    { shortname: "out", name: "Outdoors" },
+    { shortname: "po", name: "Papercraft & Origami" },
+    { shortname: "pol", name: "Politically Incorrect" },
+    { shortname: "pw", name: "Professional Wrestling" },
+    { shortname: "qst", name: "Quest" },
+    { shortname: "sci", name: "Science & Math" },
+    { shortname: "soc", name: "Social" },
+    { shortname: "sp", name: "Sports" },
+    { shortname: "tg", name: "Traditional Games" },
+    { shortname: "toy", name: "Toys" },
+    { shortname: "trv", name: "Travel" },
+    { shortname: "tv", name: "Television & Film" },
+    { shortname: "vp", name: "Veteran Posts" },
+    { shortname: "vt", name: "Virtual YouTubers" },
+    { shortname: "wsg", name: "Worksafe GIF" },
+    { shortname: "wsr", name: "Worksafe Requests" },
+    { shortname: "x", name: "Paranormal" },
+    { shortname: "xs", name: "Extreme Sports" },
+];
+export async function listBoards() {
+    let site;
+    try {
+        const url = buildUrl("/boards/");
+        const body = await apiFetch(url);
+        site = body.site ?? { url: getBaseUrl(), name: "4chan", title: "4chan", global_search_enabled: true };
+    }
+    catch {
+        site = { url: getBaseUrl(), name: "4chan", title: "4chan", global_search_enabled: true };
+    }
+    const boards = FOURCHAN_BOARDS.map((b) => ({
+        ...b,
+        search_enabled: true,
+    }));
+    return { site, boards };
+}
+export function parseGhostNum(num) {
+    const parts = num.split("_");
+    return { postNum: parts[0], subnum: parts[1] || "0" };
+}
+//# sourceMappingURL=foolfuuka.js.map

package/dist/foolfuuka.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foolfuuka.js","sourceRoot":"","sources":["../src/foolfuuka.ts"],"names":[],"mappings":"AAQA,SAAS,UAAU;IACjB,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,yBAAyB,CAAC;AACrE,CAAC;AAED,SAAS,YAAY;IACnB,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,0BAA0B,CAAC;AACxE,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,MAAoD;IAClF,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,cAAc,IAAI,EAAE,CAAC,CAAC;IACjD,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAW;IACjC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,OAAO,EAAE,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE;KAC1C,CAAC,CAAC;IAEH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,UAAU;YACpB,CAAC,CAAC,6BAA6B,UAAU,WAAW;YACpD,CAAC,CAAC,gCAAgC,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,IAAI,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAA6B,CAAC;YAC5D,IAAI,OAAO,EAAE,KAAK;gBAAE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC,CAAC,2BAA2B,CAAC,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,IAAI,GAAY,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAEvC,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAK,IAAgC,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CAAC,MAAM,CAAE,IAA+B,CAAC,KAAK,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAoB;IACpD,MAAM,WAAW,GAAgD,EAAE,CAAC;IACpE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,CAA0B,CAAC;IAE1D,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;IAE1E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI;QACpB,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;QAC5E,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,KAAa,EACb,GAAW,EACX,aAAsB,EACtB,UAAmB;IAEnB,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,CAA0B,CAAC;IAE1D,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,EAAU,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAEhD,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAElD,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAa,EAAE,GAAW;IACtD,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAS,CAAC;IACzC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,eAAe,GAA+C;IAClE,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,eAAe,EAAE;IACzC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE;IAClC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE;IACtC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,oBAAoB,EAAE;IAC9C,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE;IACjC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE;IACjC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE;IACtC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;IACjC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE;IAClC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE;IAC5C,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE;IACnC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE;IACjC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE;IAChC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE;IACvC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,sBAAsB,EAAE;IAChD,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE;IACpC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE;IAChC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE;IACvC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,qBAAqB,EAAE;IAChD,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE;IAC9C,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE;IAChD,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE;IACxC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE;IAC9C,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,sBAAsB,EAAE;IAClD,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE;IACtC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,oBAAoB,EAAE;IAC/C,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE;IAClC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE;IAC7C,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE;IACvC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE;IAC7C,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,sBAAsB,EAAE;IAClD,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE;IACtC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE;IACzC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;IACnC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE;IAChC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE;IAChC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE;IAC5C,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE;IACpC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE;IAC7C,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;IACrC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE;IAChD,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE;IAC3C,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE;IAC3C,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE;IAC9C,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE;IAC5C,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;IACpC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE;IACrC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE;IAC3C,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE;IACrC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,sBAAsB,EAAE;IAClD,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE;IAC3C,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE;IAC1C,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE;IACxC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE;IAC5C,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE;IAClC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,gBAAgB,EAAE;IAC1C,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE;IAC3C,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE;IACtC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,sBAAsB,EAAE;IACjD,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,uBAAuB,EAAE;IACnD,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,wBAAwB,EAAE;IACnD,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE;IACnC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE;IAC5C,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE;IACpC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;IACnC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE;IAC9C,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE;IAClC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE;IACpC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE;IAC9C,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE;IAC1C,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE;IAC9C,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE;IAC1C,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,mBAAmB,EAAE;IAC/C,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE;IACtC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE;CAC5C,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,UAAU;IAI9B,IAAI,IAAkF,CAAC;IAEvF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAmB,CAAC;QACnD,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC;IACxG,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC;IAC3F,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzC,GAAG,CAAC;QACJ,cAAc,EAAE,IAAI;KACrB,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;AACxD,CAAC"}

package/dist/format.d.ts

@@ -0,0 +1,21 @@
+import type { Post, Media } from "./types.js";
+export declare function formatSuccess(text: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function formatError(text: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function formatHumanSize(bytes: string | null): string;
+export declare function sanitizeTableCell(text: string, maxLen?: number): string;
+export declare function formatPostContent(comment: string | null): string;
+export declare function formatMediaLine(media: Media | null, includeUrl?: boolean): string;
+export declare function formatTimestamp(ts: number | string, short?: boolean): string;
+export declare function formatAuthorLine(name: string, trip: string | null, capcode: string): string;
+export declare function formatPostMeta(post: Post): string[];
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM;;;;;EAEzC;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM;;;;;EAEvC;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAO5D;AAOD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,MAAM,CAMpE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAMhE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,UAAU,UAAQ,GAAG,MAAM,CAU/E;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,UAAQ,GAAG,MAAM,CAY1E;AASD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAM3F;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAInD"}

package/dist/format.js

@@ -0,0 +1,87 @@
+export function formatSuccess(text) {
+    return { content: [{ type: "text", text }] };
+}
+export function formatError(text) {
+    return { content: [{ type: "text", text: `**Error:** ${text}` }] };
+}
+export function formatHumanSize(bytes) {
+    if (!bytes)
+        return "";
+    const n = parseInt(bytes, 10);
+    if (isNaN(n))
+        return bytes;
+    if (n < 1024)
+        return `${n} B`;
+    if (n < 1048576)
+        return `${Math.round(n / 1024)} KB`;
+    return `${(n / 1048576).toFixed(1)} MB`;
+}
+function formatDimensions(w, h) {
+    if (!w || !h)
+        return "";
+    return `${parseInt(w, 10)}×${parseInt(h, 10)}`;
+}
+export function sanitizeTableCell(text, maxLen = 120) {
+    const withoutNewlines = text.replace(/\s+/g, " ").trim();
+    const truncated = withoutNewlines.length > maxLen
+        ? withoutNewlines.slice(0, maxLen) + "..."
+        : withoutNewlines;
+    return truncated.replace(/\|/g, "\\|");
+}
+export function formatPostContent(comment) {
+    if (!comment)
+        return "> *[no content]*";
+    return comment
+        .split("\n")
+        .map((line) => `> ${line}`)
+        .join("\n");
+}
+export function formatMediaLine(media, includeUrl = false) {
+    if (!media || !media.media_filename)
+        return "";
+    const filename = media.media_filename;
+    const dims = formatDimensions(media.media_w, media.media_h);
+    const size = formatHumanSize(media.media_size);
+    let line = `📎 ${filename} (${dims}${size ? `, ${size}` : ""})`;
+    if (includeUrl && media.media_link) {
+        line += `\n[View image](${media.media_link})`;
+    }
+    return line;
+}
+export function formatTimestamp(ts, short = false) {
+    const n = typeof ts === "string" ? parseInt(ts, 10) : ts;
+    if (isNaN(n))
+        return String(ts);
+    const d = new Date(n * 1000);
+    const y = d.getUTCFullYear();
+    const mo = String(d.getUTCMonth() + 1).padStart(2, "0");
+    const day = String(d.getUTCDate()).padStart(2, "0");
+    if (short)
+        return `${y}-${mo}-${day}`;
+    const h = String(d.getUTCHours()).padStart(2, "0");
+    const mi = String(d.getUTCMinutes()).padStart(2, "0");
+    const s = String(d.getUTCSeconds()).padStart(2, "0");
+    return `${y}-${mo}-${day} ${h}:${mi}:${s} UTC`;
+}
+const capcodeLabels = {
+    M: "Mod",
+    A: "Admin",
+    D: "Developer",
+    V: "Verified",
+};
+export function formatAuthorLine(name, trip, capcode) {
+    let result = name;
+    if (trip)
+        result += ` !!${trip}`;
+    const label = capcodeLabels[capcode];
+    if (label)
+        result += ` (${label})`;
+    return result;
+}
+export function formatPostMeta(post) {
+    const lines = [];
+    if (post.title)
+        lines.push(`**Subject:** ${post.title}`);
+    return lines;
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { searchPosts, getThread, getPost, listBoards, } from "./foolfuuka.js";
+import { formatSuccess, formatError, sanitizeTableCell, formatPostContent, formatMediaLine, formatTimestamp, formatAuthorLine, formatPostMeta, } from "./format.js";
+const server = new McpServer({ name: "foolfuuka-mcp-server", version: "0.1.0" }, { capabilities: { tools: {} } });
+server.registerTool("search_archive", {
+    description: "Full-text search across archived 4chan posts. Filter by board, text, date range, file type, and more. Returns matching posts with excerpts and metadata.",
+    inputSchema: {
+        text: z.string().optional().describe("Comment text to search for"),
+        boards: z.string().optional().describe("Dot-delimited board shortnames, e.g. \"a\" or \"adv.trv\". Omit to search all boards"),
+        subject: z.string().optional().describe("OP subject line search"),
+        username: z.string().optional().describe("Poster name match"),
+        tripcode: z.string().optional().describe("Tripcode match"),
+        capcode: z.string().optional().describe("One of: user, mod, admin, dev, manager, founder"),
+        filename: z.string().optional().describe("Original filename search"),
+        image: z.string().optional().describe("Base64 MD5 hash of media"),
+        uid: z.string().optional().describe("4chan Pass UID"),
+        country: z.string().optional().describe("2-letter ISO 3166 country code"),
+        deleted: z.string().optional().describe("deleted or not-deleted"),
+        ghost: z.string().optional().describe("only or none"),
+        filter: z.string().optional().describe("image or text"),
+        type: z.string().optional().describe("sticky, op, or posts"),
+        start: z.string().optional().describe("Start date in YYYY-MM-DD format"),
+        end: z.string().optional().describe("End date in YYYY-MM-DD format"),
+        results: z.string().optional().describe("thread to group by thread, otherwise flat"),
+        order: z.string().default("desc").describe("asc or desc"),
+        page: z.number().default(1).describe("Page number (1-indexed, 25 posts per page)"),
+    },
+}, async (args) => {
+    try {
+        const result = await searchPosts(args);
+        if (result.posts.length === 0) {
+            return formatSuccess(`No posts found matching "${args.text ?? ""}".`);
+        }
+        const isMultiBoard = !args.boards || args.boards.includes(".");
+        const totalFound = result.meta?.total_found ?? result.posts.length;
+        const maxResults = result.meta?.max_results ?? 0;
+        const totalPages = maxResults > 0 ? Math.ceil(maxResults / 25) : 1;
+        let md = `## Search: "${args.text ?? ""}"${args.boards ? ` on /${args.boards}/` : " (all boards)"}\n\n`;
+        md += `Found ${result.posts.length} of ${totalFound.toLocaleString()} matching posts (page ${args.page} of ${totalPages}, 25 per page)\n\n`;
+        if (isMultiBoard) {
+            md += "| Board | Post | Date | Author | Excerpt |\n|-------|------|------|--------|---------|\n";
+        }
+        else {
+            md += "| Post | Date | Author | Excerpt |\n|------|------|--------|---------|\n";
+        }
+        for (const post of result.posts) {
+            const boardShort = post.board?.shortname ? `/${post.board.shortname}/` : "";
+            const excerpt = sanitizeTableCell(post.comment_sanitized || "");
+            const date = formatTimestamp(post.timestamp, true);
+            const author = sanitizeTableCell(post.name, 40);
+            if (isMultiBoard) {
+                md += `| ${boardShort} | #${post.num} | ${date} | ${author} | ${excerpt} |\n`;
+            }
+            else {
+                md += `| #${post.num} | ${date} | ${author} | ${excerpt} |\n`;
+            }
+        }
+        md += `\n*Use \`get_thread\` to view a full thread or \`get_post\` for a single post.*`;
+        return formatSuccess(md);
+    }
+    catch (err) {
+        return formatError(err instanceof Error ? err.message : String(err));
+    }
+});
+server.registerTool("get_thread", {
+    description: "Retrieve all posts in a thread from a 4chan archive. Returns the OP post and all replies with full content, timestamps, and media attachments.",
+    inputSchema: {
+        board: z.string().describe("Board shortname, e.g. \"a\""),
+        num: z.number().describe("Thread OP post number"),
+        latest_doc_id: z.number().optional().describe("For incremental fetch; returns only posts after this internal doc_id"),
+        last_limit: z.number().default(100).describe("Only return the last N posts. Default 100. Pass 0 for all."),
+    },
+}, async (args) => {
+    try {
+        const { op, posts } = await getThread(args.board, args.num, args.latest_doc_id, args.last_limit);
+        const postEntries = Object.entries(posts);
+        let md = `## Thread #${args.num} on /${args.board}/\n\n`;
+        if (args.latest_doc_id) {
+            md += `Showing ${postEntries.length} new posts since doc_id ${args.latest_doc_id}\n\n`;
+        }
+        else if (args.last_limit > 0) {
+            md += `Showing last ${Math.min(args.last_limit, postEntries.length)} of ${postEntries.length} posts\n\n`;
+        }
+        const postToMd = (post, isOp) => {
+            const ghost = post.subnum !== "0" ? " (ghost)" : "";
+            const lineStart = isOp ? "**OP**" : `**#${post.num}**${ghost}`;
+            md += `${lineStart} by ${formatAuthorLine(post.name, post.trip, post.capcode)} — ${formatTimestamp(post.timestamp)}\n`;
+            for (const meta of formatPostMeta(post)) {
+                md += `${meta}\n`;
+            }
+            md += `${formatPostContent(post.comment_sanitized)}\n`;
+            const mediaLine = formatMediaLine(post.media, false);
+            if (mediaLine)
+                md += `${mediaLine}\n`;
+        };
+        postToMd(op, true);
+        md += `\n---\n\n`;
+        for (const [, post] of postEntries) {
+            postToMd(post, false);
+            md += `\n---\n\n`;
+        }
+        return formatSuccess(md.trim());
+    }
+    catch (err) {
+        return formatError(err instanceof Error ? err.message : String(err));
+    }
+});
+server.registerTool("get_post", {
+    description: "Retrieve a single post from a 4chan archive by board and post number. Includes post content, author info, timestamps, and media if present.",
+    inputSchema: {
+        board: z.string().describe("Board shortname, e.g. \"a\""),
+        num: z.string().describe("Post number. Can include _ suffix for ghost posts, e.g. \"676_1\""),
+    },
+}, async (args) => {
+    try {
+        const post = await getPost(args.board, args.num);
+        const ghost = post.subnum !== "0" ? " (ghost)" : "";
+        let md = `## Post #${args.num}${ghost} on /${args.board}/\n\n`;
+        md += `**Author:** ${formatAuthorLine(post.name, post.trip, post.capcode)} | **Date:** ${formatTimestamp(post.timestamp)}\n`;
+        md += `**Board:** /${args.board}/ | **Thread:** #${post.thread_num}\n`;
+        for (const meta of formatPostMeta(post)) {
+            md += `${meta}\n`;
+        }
+        md += `\n${formatPostContent(post.comment_sanitized)}\n`;
+        const mediaLine = formatMediaLine(post.media, true);
+        if (mediaLine)
+            md += `\n${mediaLine}\n`;
+        return formatSuccess(md.trim());
+    }
+    catch (err) {
+        return formatError(err instanceof Error ? err.message : String(err));
+    }
+});
+server.registerTool("list_boards", {
+    description: "List all available boards on the configured 4chan archive. Returns board shortnames and full names, plus site metadata.",
+    inputSchema: {},
+}, async () => {
+    try {
+        const { site, boards } = await listBoards();
+        let md = `## ${site.name}\n\nAvailable boards:\n\n`;
+        md += "| Board | Name |\n|-------|------|\n";
+        for (const b of boards) {
+            md += `| /${b.shortname}/ | ${b.name} |\n`;
+        }
+        const searchEnabled = boards.filter((b) => b.search_enabled).length;
+        md += `\n*Search enabled on ${searchEnabled} of ${boards.length} boards.*`;
+        return formatSuccess(md);
+    }
+    catch (err) {
+        return formatError(err instanceof Error ? err.message : String(err));
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,123 @@
+export interface Media {
+    media_id: string;
+    spoiler: "0" | "1";
+    preview_orig: string | null;
+    media: string | null;
+    preview_op: string | null;
+    preview_reply: string | null;
+    preview_w: string | null;
+    preview_h: string | null;
+    media_filename: string | null;
+    media_w: string | null;
+    media_h: string | null;
+    media_size: string | null;
+    media_hash: string | null;
+    media_orig: string | null;
+    total: string;
+    banned: "0" | "1";
+    media_status: string;
+    remote_media_link: string | null;
+    media_link: string | null;
+    thumb_link: string | null;
+    media_filename_processed: string | null;
+}
+export interface Post {
+    doc_id: string;
+    num: string;
+    subnum: string;
+    thread_num: string;
+    op: "0" | "1";
+    timestamp: number | string;
+    capcode: string;
+    email: string | null;
+    name: string;
+    trip: string | null;
+    title: string | null;
+    comment: string | null;
+    comment_sanitized: string;
+    comment_processed: string;
+    poster_hash: string | null;
+    poster_country: string | null;
+    sticky: "0" | "1";
+    locked: "0" | "1";
+    deleted: "0" | "1";
+    nreplies: number | string | null;
+    nimages: number | string | null;
+    fourchan_date: string;
+    formatted: boolean;
+    media: Media | null;
+    board?: BoardInfo;
+}
+export interface BoardInfo {
+    name: string;
+    shortname: string;
+}
+export interface Site {
+    url: string;
+    name: string;
+    title: string;
+    global_search_enabled: boolean;
+}
+export interface SearchMeta {
+    total_found: number;
+    max_results: number;
+    search_title: string;
+}
+export interface SearchResponse {
+    "0": {
+        posts: Post[];
+    };
+    meta?: SearchMeta;
+}
+export interface ThreadResponse {
+    [threadNum: string]: {
+        op: Post;
+        posts: {
+            [postNum: string]: Post;
+        };
+    };
+}
+export interface BoardsResponse {
+    site: Site;
+    boards: Record<string, BoardRaw>;
+}
+export interface BoardRaw {
+    name: string;
+    shortname: string;
+    board_url: string;
+    threads_per_page: string;
+    search_enabled: boolean;
+    is_nsfw: boolean;
+}
+export interface SearchParams {
+    text?: string;
+    boards?: string;
+    subject?: string;
+    username?: string;
+    tripcode?: string;
+    capcode?: string;
+    filename?: string;
+    image?: string;
+    uid?: string;
+    country?: string;
+    deleted?: string;
+    ghost?: string;
+    filter?: string;
+    type?: string;
+    start?: string;
+    end?: string;
+    results?: string;
+    order?: string;
+    page?: number;
+}
+export interface ThreadParams {
+    board: string;
+    num: number;
+    latest_doc_id?: number;
+    last_limit?: number;
+}
+export interface PostParams {
+    board: string;
+    num: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "foolfuuka-mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for querying 4chan archives via the FoolFuuka API",
+  "type": "module",
+  "bin": {
+    "foolfuuka-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dynmie/foolfuuka-mcp-server.git"
+  },
+  "keywords": [
+    "mcp",
+    "4chan",
+    "foolfuuka",
+    "archive",
+    "desuarchive"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.16.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.9"
+  }
+}