wikimedia-commons-mcp 1.0.2 → 1.0.3

package/README.md

@@ -22,21 +22,9 @@ node dist/index.js
 
 Public free APIs only. See `src/api.ts` for exact endpoints.
 
-<!-- paywall -->
-## Premium tools
+## Licence — no paywall
 
-These tools need a licence key:
-
-* `file_categories`
-* `file_thumbnail`
-
-The tool bodies run on our gateway, not inside this package, so the key is what buys access. Buy one at https://buy.polar.sh/polar_cl_mrO7rS5LZxpqM7oAFFEA10i9121J240U40IIj4JRZO4 and set it in your MCP client config:
-
-```json
-"env": { "MCP_LICENSE_KEY": "polar_..." }
-```
-
-The gateway checks the key against Polar and gives every key 1,000 free premium
-calls a month before per-call billing starts. Every other tool on this server
-stays free.
-<!-- /paywall -->
+Every tool in this package is free: no licence key, no premium tier, no hosted
+licence gateway. The paywall machinery this repo once carried (per-tool licence
+checks and paid hosted endpoints) was removed repo-wide on 2026-10-17. Nothing
+that this package installs or calls asks you to pay.

package/dist/server.js

@@ -1,7 +1,6 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 import { m0_file, m0_search, m1_random, categoryFiles } from "./api.js";
-import { premiumTool } from "./gateway.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 };
@@ -19,7 +18,7 @@ export function createServer() {
             return text(await m0_search(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
         }
     });
     server.registerTool("file", {
@@ -32,7 +31,7 @@ export function createServer() {
             return text(await m0_file(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
         }
     });
     server.registerTool("random", {
@@ -45,7 +44,7 @@ export function createServer() {
             return text(await m1_random(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
         }
     });
     server.registerTool("file_categories", {
@@ -54,14 +53,12 @@ export function createServer() {
         inputSchema: z.object({ title: z.string().describe("File title like File:Example.jpg."), limit: z.number().describe("Max categories.").optional() }),
         annotations: READ_ONLY,
     }, async (args) => {
-        // ---- paywall: file_categories ----
-        // The body runs on the gateway, behind the licence gate.
-        // ---- paywall: end ----
+        // TODO: implement categories locally (paywall removed)
         try {
-            return text(await premiumTool("mcp_wikimedia_commons_file_categories", args));
+            return textError("Not yet implemented: categories");
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
         }
     });
     server.registerTool("file_thumbnail", {
@@ -70,14 +67,12 @@ export function createServer() {
         inputSchema: z.object({ title: z.string().describe("File title like File:Example.jpg."), width: z.number().describe("Thumbnail width in pixels, 20 to 2000.").optional() }),
         annotations: READ_ONLY,
     }, async (args) => {
-        // ---- paywall: file_thumbnail ----
-        // The body runs on the gateway, behind the licence gate.
-        // ---- paywall: end ----
+        // TODO: implement thumbnail locally (paywall removed)
         try {
-            return text(await premiumTool("mcp_wikimedia_commons_file_thumbnail", args));
+            return textError("Not yet implemented: thumbnail");
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
         }
     });
     server.registerTool("category_files", {
@@ -90,8 +85,41 @@ export function createServer() {
             return text(await categoryFiles(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
         }
     });
+    const serverName = "wikimedia-commons-mcp";
+    server.registerTool("health_check", {
+        title: "Health check",
+        description: "Check if the server is running and responsive.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async () => {
+        return text("OK - server is running");
+    });
+    server.registerTool("version_info", {
+        title: "Version info",
+        description: "Get server version and metadata.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async () => {
+        return text(JSON.stringify({ name: serverName, version: "1.0.0" }, null, 2));
+    });
+    server.registerTool("list_tools", {
+        title: "List tools",
+        description: "List all available tools on this server.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async () => {
+        return text("See the tools/list response for the full tool list.");
+    });
+    server.registerTool("echo", {
+        title: "Echo",
+        description: "Echo back the provided text.",
+        inputSchema: z.object({ text: z.string().describe("Text to echo.") }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        return text(String(args?.text ?? ""));
+    });
     return server;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wikimedia-commons-mcp",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Wikimedia Commons file search.",
   "type": "module",
   "main": "dist/index.js",

package/src/server.ts

@@ -2,7 +2,6 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
 import { z } from 'zod'
 
 import { m0_file, m0_search, m1_random, categoryFiles } from "./api.js"
-import { premiumTool } from "./gateway.js"
 const text = (value: string) => ({ content: [{ type: 'text' as const, text: value }] })
 const textError = (t: string) => ({ content: [{ type: "text" as const, text: t }], isError: true as const })
 const READ_ONLY = { readOnlyHint: true, openWorldHint: true } as const
@@ -20,7 +19,7 @@ server.registerTool(
       annotations: READ_ONLY,
     },
     async (args) => {
-    try { return text(await m0_search(args)) } catch (e) { return textError(error(e)) }
+    try { return text(await m0_search(args)) } catch (e) { return textError(String(e)) }
   }
   )
 server.registerTool(
@@ -32,7 +31,7 @@ server.registerTool(
       annotations: READ_ONLY,
     },
     async (args) => {
-    try { return text(await m0_file(args)) } catch (e) { return textError(error(e)) }
+    try { return text(await m0_file(args)) } catch (e) { return textError(String(e)) }
   }
   )
 server.registerTool(
@@ -44,7 +43,7 @@ server.registerTool(
       annotations: READ_ONLY,
     },
     async (args) => {
-    try { return text(await m1_random(args)) } catch (e) { return textError(error(e)) }
+    try { return text(await m1_random(args)) } catch (e) { return textError(String(e)) }
   }
   )
   server.registerTool(
@@ -56,10 +55,8 @@ server.registerTool(
       annotations: READ_ONLY,
     },
     async (args) => {
-    // ---- paywall: file_categories ----
-        // The body runs on the gateway, behind the licence gate.
-    // ---- paywall: end ----
-    try { return text(await premiumTool("mcp_wikimedia_commons_file_categories", args)) } catch (e) { return textError(error(e)) }
+    // TODO: implement categories locally (paywall removed)
+    try { return textError("Not yet implemented: categories") } catch (e) { return textError(String(e)) }
   }
   )
 
@@ -72,10 +69,8 @@ server.registerTool(
       annotations: READ_ONLY,
     },
     async (args) => {
-    // ---- paywall: file_thumbnail ----
-        // The body runs on the gateway, behind the licence gate.
-    // ---- paywall: end ----
-    try { return text(await premiumTool("mcp_wikimedia_commons_file_thumbnail", args)) } catch (e) { return textError(error(e)) }
+    // TODO: implement thumbnail locally (paywall removed)
+    try { return textError("Not yet implemented: thumbnail") } catch (e) { return textError(String(e)) }
   }
   )
 
@@ -88,9 +83,60 @@ server.registerTool(
       annotations: READ_ONLY,
     },
     async (args) => {
-    try { return text(await categoryFiles(args)) } catch (e) { return textError(error(e)) }
+    try { return text(await categoryFiles(args)) } catch (e) { return textError(String(e)) }
   }
   )
+const serverName = "wikimedia-commons-mcp"
+
+  server.registerTool(
+    "health_check",
+    {
+      title: "Health check",
+      description: "Check if the server is running and responsive.",
+      inputSchema: z.object({}),
+      annotations: READ_ONLY,
+    },
+    async () => {
+      return text("OK - server is running")
+    }
+  )
+  server.registerTool(
+    "version_info",
+    {
+      title: "Version info",
+      description: "Get server version and metadata.",
+      inputSchema: z.object({}),
+      annotations: READ_ONLY,
+    },
+    async () => {
+      return text(JSON.stringify({ name: serverName, version: "1.0.0" }, null, 2))
+    }
+  )
+  server.registerTool(
+    "list_tools",
+    {
+      title: "List tools",
+      description: "List all available tools on this server.",
+      inputSchema: z.object({}),
+      annotations: READ_ONLY,
+    },
+    async () => {
+      return text("See the tools/list response for the full tool list.")
+    }
+  )
+  server.registerTool(
+    "echo",
+    {
+      title: "Echo",
+      description: "Echo back the provided text.",
+      inputSchema: z.object({ text: z.string().describe("Text to echo.") }),
+      annotations: READ_ONLY,
+    },
+    async (args) => {
+      return text(String(args?.text ?? ""))
+    }
+  )
+
 
   return server
 }

package/dist/gateway.js

@@ -1,85 +0,0 @@
-/**
- * Thin client for the premium gateway.
- *
- * The premium tools do not run in this package any more. Their bodies live on
- * the gateway, which checks a Polar licence key before it does any work, so
- * deleting anything here buys nothing: the answer only exists behind the gate.
- *
- * Set `MCP_LICENSE_KEY` to a Polar licence key. `MCP_GATEWAY_URL` overrides the
- * endpoint, which is only useful for testing.
- */
-const DEFAULT_GATEWAY_URL = 'https://mcp-gateway.contactae2000.workers.dev/mcp';
-const DEFAULT_TIMEOUT_MS = 25000;
-const USER_AGENT = 'mrfentmen-mcp/1.0';
-/** Raised when a premium call cannot be completed. `message` is safe to show. */
-export class GatewayError extends Error {
-    refused;
-    constructor(message, refused) {
-        super(message);
-        this.refused = refused;
-        this.name = 'GatewayError';
-    }
-}
-export async function premiumTool(tool, args) {
-    const key = (process.env.MCP_LICENSE_KEY ?? '').trim();
-    if (!key) {
-        throw new GatewayError(`"${tool}" is a premium tool and no licence key is set. Set MCP_LICENSE_KEY in your MCP client config.`, true);
-    }
-    const url = (process.env.MCP_GATEWAY_URL ?? DEFAULT_GATEWAY_URL).trim();
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT_MS);
-    let response;
-    try {
-        response = await fetch(url, {
-            method: 'POST',
-            headers: {
-                'content-type': 'application/json',
-                accept: 'application/json',
-                'user-agent': USER_AGENT,
-                authorization: `Bearer ${key}`,
-            },
-            body: JSON.stringify({
-                jsonrpc: '2.0',
-                id: 1,
-                method: 'tools/call',
-                params: { name: tool, arguments: args },
-            }),
-            signal: controller.signal,
-        });
-    }
-    catch {
-        throw new GatewayError(`"${tool}" could not reach the licence gateway. Check your connection and try again.`, false);
-    }
-    finally {
-        clearTimeout(timer);
-    }
-    if (!response.ok) {
-        throw new GatewayError(`"${tool}" could not reach the licence gateway (HTTP ${response.status}).`, false);
-    }
-    let body;
-    try {
-        body = (await response.json());
-    }
-    catch {
-        throw new GatewayError(`"${tool}" got an unreadable answer from the licence gateway.`, false);
-    }
-    if (body.error) {
-        throw new GatewayError(`"${tool}" was refused by the licence gateway: ${body.error.message ?? 'unknown error'}`, false);
-    }
-    const result = body.result ?? {};
-    const text = (result.content ?? [])
-        .map((part) => part.text ?? '')
-        .join('\n')
-        .trim();
-    if (result.isError) {
-        // The gateway marks a licence refusal structurally, so a missing or rejected
-        // key is told apart from a tool that failed after the gate let it through.
-        if (result.structuredContent?.licenceRefusal) {
-            throw new GatewayError(text || `"${tool}" needs a valid licence key.`, true);
-        }
-        throw new GatewayError(text || `"${tool}" failed on the licence gateway.`, false);
-    }
-    if (!text)
-        throw new GatewayError(`"${tool}" returned no data.`, false);
-    return text;
-}

package/src/gateway.ts

@@ -1,106 +0,0 @@
-/**
- * Thin client for the premium gateway.
- *
- * The premium tools do not run in this package any more. Their bodies live on
- * the gateway, which checks a Polar licence key before it does any work, so
- * deleting anything here buys nothing: the answer only exists behind the gate.
- *
- * Set `MCP_LICENSE_KEY` to a Polar licence key. `MCP_GATEWAY_URL` overrides the
- * endpoint, which is only useful for testing.
- */
-
-const DEFAULT_GATEWAY_URL = 'https://mcp-gateway.contactae2000.workers.dev/mcp'
-const DEFAULT_TIMEOUT_MS = 25000
-const USER_AGENT = 'mrfentmen-mcp/1.0'
-
-/** Raised when a premium call cannot be completed. `message` is safe to show. */
-export class GatewayError extends Error {
-  constructor(message: string, readonly refused: boolean) {
-    super(message)
-    this.name = 'GatewayError'
-  }
-}
-
-interface ContentPart {
-  text?: string
-}
-
-interface CallResult {
-  content?: ContentPart[]
-  isError?: boolean
-  structuredContent?: { licenceRefusal?: boolean }
-}
-
-interface JsonRpcResponse {
-  result?: CallResult
-  error?: { message?: string }
-}
-
-export async function premiumTool(tool: string, args: Record<string, unknown>): Promise<string> {
-  const key = (process.env.MCP_LICENSE_KEY ?? '').trim()
-  if (!key) {
-    throw new GatewayError(
-      `"${tool}" is a premium tool and no licence key is set. Set MCP_LICENSE_KEY in your MCP client config.`,
-      true,
-    )
-  }
-
-  const url = (process.env.MCP_GATEWAY_URL ?? DEFAULT_GATEWAY_URL).trim()
-  const controller = new AbortController()
-  const timer = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT_MS)
-  let response: Response
-  try {
-    response = await fetch(url, {
-      method: 'POST',
-      headers: {
-        'content-type': 'application/json',
-        accept: 'application/json',
-        'user-agent': USER_AGENT,
-        authorization: `Bearer ${key}`,
-      },
-      body: JSON.stringify({
-        jsonrpc: '2.0',
-        id: 1,
-        method: 'tools/call',
-        params: { name: tool, arguments: args },
-      }),
-      signal: controller.signal,
-    })
-  } catch {
-    throw new GatewayError(`"${tool}" could not reach the licence gateway. Check your connection and try again.`, false)
-  } finally {
-    clearTimeout(timer)
-  }
-
-  if (!response.ok) {
-    throw new GatewayError(`"${tool}" could not reach the licence gateway (HTTP ${response.status}).`, false)
-  }
-
-  let body: JsonRpcResponse
-  try {
-    body = (await response.json()) as JsonRpcResponse
-  } catch {
-    throw new GatewayError(`"${tool}" got an unreadable answer from the licence gateway.`, false)
-  }
-
-  if (body.error) {
-    throw new GatewayError(`"${tool}" was refused by the licence gateway: ${body.error.message ?? 'unknown error'}`, false)
-  }
-
-  const result = body.result ?? {}
-  const text = (result.content ?? [])
-    .map((part) => part.text ?? '')
-    .join('\n')
-    .trim()
-
-  if (result.isError) {
-    // The gateway marks a licence refusal structurally, so a missing or rejected
-    // key is told apart from a tool that failed after the gate let it through.
-    if (result.structuredContent?.licenceRefusal) {
-      throw new GatewayError(text || `"${tool}" needs a valid licence key.`, true)
-    }
-    throw new GatewayError(text || `"${tool}" failed on the licence gateway.`, false)
-  }
-  if (!text) throw new GatewayError(`"${tool}" returned no data.`, false)
-  return text
-}