mcp-metacritic 1.0.1 → 1.0.3

package/README.md

@@ -167,6 +167,19 @@ Metacritic and link the entry: every result carries a `source_url`.
 This is an unofficial project, with no affiliation to or endorsement by
 Metacritic or Fandom.
 
+## Contributing
+
+Bugs, questions and ideas all belong in
+[the issue tracker](https://github.com/smeet666/mcp-metacritic/issues). Pull requests
+are welcome; please open an issue first so we can agree on what the right
+answer is before you write it. [CONTRIBUTING.md](CONTRIBUTING.md) has the
+detail, and [SECURITY.md](SECURITY.md) covers anything exploitable.
+
+## Support
+
+These servers are free and stay free. If one of them saved you an afternoon,
+you can [buy me a coffee](https://buymeacoffee.com/smeet666).
+
 ## License
 
 MIT. See [LICENSE](./LICENSE). The license covers this source code only, not the

package/dist/index.js

@@ -4,7 +4,7 @@
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
 // src/version.ts
-var PKG_VERSION = "1.0.1";
+var PKG_VERSION = "1.0.3";
 var REPO_URL = "https://github.com/smeet666/mcp-metacritic";
 
 // src/config.ts
@@ -129,6 +129,7 @@ function createLogger(level) {
 
 // src/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z as z6 } from "zod";
 
 // src/mc/cache.ts
 var TtlLruCache = class {
@@ -946,7 +947,13 @@ function toScoreOut(score) {
     sentiment: score.sentiment
   };
 }
-function ok(structured, body, trailer = ATTRIBUTION) {
+function ok(structured, body, options = {}) {
+  const attribution = options.sourceUrl ? `${ATTRIBUTION} \u2014 ${options.sourceUrl}` : ATTRIBUTION;
+  const noteLines = (options.notes ?? []).map((note) => `Note: ${note}`);
+  while (noteLines.length > 0 && noteLines.join("\n").length > MAX_TEXT_MIRROR_CHARS / 2) {
+    noteLines.pop();
+  }
+  const trailer = [...noteLines, attribution].join("\n");
   const cutMarker = "\n\n[shortened; the full result is in the structured output]";
   const reserved = `
 
@@ -1074,7 +1081,8 @@ ${renderTitleList(results)}`;
         next_offset: nextOffset,
         notes
       },
-      summary
+      summary,
+      { notes }
     );
   } catch (error) {
     return toToolError(error);
@@ -1194,7 +1202,8 @@ ${listing}`;
         next_offset: nextOffset,
         notes
       },
-      summary
+      summary,
+      { notes, sourceUrl }
     );
   } catch (error) {
     return toToolError(error);
@@ -1299,23 +1308,23 @@ async function runGetTitle(client, args) {
       notes
     };
     if (wanted.has("awards")) structured.awards = item.awards;
+    const PRODUCTION_CAP = 25;
+    const production = wanted.has("production") ? item.production.slice(0, PRODUCTION_CAP) : [];
     if (wanted.has("production")) {
-      const CAP = 25;
-      structured.production = item.production.slice(0, CAP);
-      if (item.production.length > CAP) {
+      structured.production = production;
+      if (item.production.length > PRODUCTION_CAP) {
         notes.push(
-          `${item.production.length} companies are credited and the first ${CAP} are shown. The list mixes producers with distributors and home-video labels across every territory.`
+          `${item.production.length} companies are credited and the first ${PRODUCTION_CAP} are shown. The list mixes producers with distributors and home-video labels across every territory.`
         );
       }
     }
     if (wanted.has("networks")) structured.networks = item.networks;
     const offers = wanted.has("where_to_watch") ? await watchOffers(client, item, args.kind, notes) : [];
     if (wanted.has("where_to_watch")) structured.where_to_watch = offers;
-    return ok(
-      structured,
-      render(item, slice, criticScore, userScore, wanted, offers),
-      `${ATTRIBUTION} \u2014 ${item.sourceUrl}`
-    );
+    return ok(structured, render(item, slice, criticScore, userScore, wanted, offers, production), {
+      notes,
+      sourceUrl: item.sourceUrl
+    });
   } catch (error) {
     return toToolError(error);
   }
@@ -1353,7 +1362,7 @@ async function watchOffers(client, item, kind, notes) {
     return [];
   }
 }
-function render(item, description, critic, user, wanted, offers) {
+function render(item, description, critic, user, wanted, offers, production) {
   const yearShown = item.year !== null && !item.title.includes(`(${item.year})`);
   const header = [item.title, yearShown ? `(${item.year})` : "", `\xB7 ${item.kind}`].filter(Boolean).join(" ");
   const lines = [header];
@@ -1385,6 +1394,12 @@ function render(item, description, critic, user, wanted, offers) {
   if (wanted.has("networks") && item.networks.length > 0) {
     lines.push("", `Networks: ${item.networks.join(", ")}`);
   }
+  if (wanted.has("production")) {
+    lines.push(
+      "",
+      production.length === 0 ? "Production: no company credited." : `Production: ${production.map((company) => company.name).join(", ")}`
+    );
+  }
   if (wanted.has("where_to_watch")) {
     lines.push("", offers.length === 0 ? "Where to watch: nothing listed." : "Where to watch:");
     for (const o of offers) lines.push(`  ${o.provider} (${o.kind})${o.url ? ` \u2014 ${o.url}` : ""}`);
@@ -1445,7 +1460,9 @@ async function runSearchTitles(client, args) {
     }
     const summary = results.length === 0 ? `No Metacritic entry matched "${args.query}".` : `${results.length} entr${results.length === 1 ? "y" : "ies"} for "${args.query}":
 ${renderTitleList(results)}`;
-    return ok({ query: args.query, results, total_available: data.totalResults, notes }, summary);
+    return ok({ query: args.query, results, total_available: data.totalResults, notes }, summary, {
+      notes
+    });
   } catch (error) {
     return toToolError(error);
   }
@@ -1477,8 +1494,8 @@ function createServer(options = {}) {
     {
       title: "Search Metacritic",
       description: searchTitlesDescription,
-      inputSchema: searchTitlesInputShape,
-      outputSchema: searchTitlesOutputShape,
+      inputSchema: z6.object(searchTitlesInputShape),
+      outputSchema: z6.object(searchTitlesOutputShape),
       annotations: READ_ONLY
     },
     async (args) => runSearchTitles(client, args)
@@ -1488,8 +1505,8 @@ function createServer(options = {}) {
     {
       title: "Read an entry",
       description: getTitleDescription,
-      inputSchema: getTitleInputShape,
-      outputSchema: getTitleOutputShape,
+      inputSchema: z6.object(getTitleInputShape),
+      outputSchema: z6.object(getTitleOutputShape),
       annotations: READ_ONLY
     },
     async (args) => runGetTitle(client, args)
@@ -1499,8 +1516,8 @@ function createServer(options = {}) {
     {
       title: "Read reviews",
       description: getReviewsDescription,
-      inputSchema: getReviewsInputShape,
-      outputSchema: getReviewsOutputShape,
+      inputSchema: z6.object(getReviewsInputShape),
+      outputSchema: z6.object(getReviewsOutputShape),
       annotations: READ_ONLY
     },
     async (args) => runGetReviews(client, args)
@@ -1510,8 +1527,8 @@ function createServer(options = {}) {
     {
       title: "Browse rankings",
       description: browseTitlesDescription,
-      inputSchema: browseTitlesInputShape,
-      outputSchema: browseTitlesOutputShape,
+      inputSchema: z6.object(browseTitlesInputShape),
+      outputSchema: z6.object(browseTitlesOutputShape),
       annotations: READ_ONLY
     },
     async (args) => runBrowseTitles(client, args)