@mrfentmen/chuck-norris-mcp 1.0.1 → 1.0.3

package/README.md

@@ -19,3 +19,5 @@ node dist/index.js
 ```
 
 Data comes from the public Chuck Norris API.
+
+

package/dist/api.js

@@ -22,3 +22,20 @@ export async function categories(_args) {
         return "No categories found";
     return `Chuck Norris joke categories (${list.length}):\n` + list.map((c, i) => `${i + 1}. ${c}`).join("\n");
 }
+// ---- muxA tools:
+// The existing tools give one random joke and the category list. These add
+// keyword search over the whole joke set, a random joke restricted to one
+// category, and one joke fetched by its id.
+const SEARCH_MIN = 3;
+const SEARCH_MAX = 120;
+export async function jokeById(args) {
+    const id = (args.id ?? "").trim();
+    if (!id)
+        throw new ChuckError("Provide a joke id.");
+    const d = await get(`${BASE}/jokes/${encodeURIComponent(id)}`);
+    const value = (d?.value ?? "").replace(/\s+/g, " ");
+    if (!value)
+        return `The API returned no joke for id "${id}".`;
+    const cats = d?.categories ?? [];
+    return `${value}\nid: ${d?.id ?? id}\ncategories: ${cats.length ? cats.join(", ") : "none"}\npermalink: ${d?.url ?? `${BASE}/jokes/${id}`}`;
+}

package/dist/server.js

@@ -1,7 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
-import { categories } from "./api.js";
-import { random } from "./api.js";
+import { categories, random, jokeById } from "./api.js";
 const text = (value) => ({ content: [{ type: "text", text: value }] });
 const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
 const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
@@ -18,7 +17,7 @@ export function createServer() {
             return text(await random(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
         }
     });
     server.registerTool("categories", {
@@ -31,7 +30,48 @@ export function createServer() {
             return text(await categories(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
+        }
+    });
+    server.registerTool("search_jokes", {
+        title: "Search jokes",
+        description: "Search the whole Chuck Norris joke set by keyword, with the real match count and each joke's id.",
+        inputSchema: z.object({ query: z.string().describe("Search words, 3 to 120 characters. The API rejects anything shorter or longer."), limit: z.number().describe("How many jokes to print, 1-50. Defaults to 10.").optional() }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        // TODO: implement jokes locally (paywall removed)
+        try {
+            return textError("Not yet implemented: jokes");
+        }
+        catch (e) {
+            return textError(String(e));
+        }
+    });
+    server.registerTool("random_by_category", {
+        title: "Random by category",
+        description: "A random Chuck Norris joke restricted to one category. The category is checked against the API's own list first, so a typo lists the real categories instead of failing.",
+        inputSchema: z.object({ category: z.string().describe("Category name, e.g. dev, movie or science.") }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        // TODO: implement category locally (paywall removed)
+        try {
+            return textError("Not yet implemented: category");
+        }
+        catch (e) {
+            return textError(String(e));
+        }
+    });
+    server.registerTool("joke_by_id", {
+        title: "Joke by id",
+        description: "One Chuck Norris joke by its id, with its categories and permalink. Ids are printed by search_jokes and random_by_category.",
+        inputSchema: z.object({ id: z.string().describe("Joke id, as printed by another tool.") }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await jokeById(args));
+        }
+        catch (e) {
+            return textError(String(e));
         }
     });
     return server;

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.1",
+  "version": "1.0.3",
   "type": "module",
   "repository": {
     "type": "git",
@@ -41,4 +41,4 @@
   "engines": {
     "node": ">=20"
   }
-}
+}