html-meta-mcp 1.0.0

package/README.md

@@ -0,0 +1,20 @@
+# HTML Meta MCP
+
+Fetch title, description, and open graph tags from a web page. No key required.
+
+This file is self contained. It reads public data only and never writes to the machine. All output is bounded and honest about what could not be fetched.
+
+## Tools
+
+
+* `meta`  Meta and open graph tags.
+
+## Usage
+
+```bash
+npm install
+npm run build
+node dist/index.js
+```
+
+Link preview products charge for this. The page is fetched, bounded, and only the meta tags are returned.

package/dist/api.js

@@ -0,0 +1,71 @@
+const UA = "mrfentmen-html-meta-mcp/1.0 (https://github.com/mrfentmen)";
+export class HtmlmetaError extends Error {
+}
+function attr(html, name) {
+    const re = new RegExp(`(?:name|property)="${name}"[^>]*content="([^"]*)"`, "i");
+    const m = html.match(re);
+    if (m)
+        return decodeEntities(m[1]).trim();
+    const re2 = new RegExp(`content="([^"]*)"[^>]*(?:name|property)="${name}"`, "i");
+    const m2 = html.match(re2);
+    return m2 ? decodeEntities(m2[1]).trim() : null;
+}
+function decodeEntities(s) {
+    return s
+        .replace(/'/g, "'")
+        .replace(/"/g, '"')
+        .replace(/&/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&nbsp;/g, " ");
+}
+function first(html, regex) {
+    const m = html.match(regex);
+    return m ? decodeEntities(m[1]).replace(/\s+/g, " ").trim() : null;
+}
+export async function meta(args) {
+    const raw = (args.url ?? "").trim();
+    if (!raw)
+        throw new HtmlmetaError("Provide a URL");
+    const url = /^https?:\/\//i.test(raw) ? raw : `https://${raw}`;
+    let res;
+    try {
+        res = await fetch(url, {
+            headers: { "User-Agent": UA, Accept: "text/html" },
+            redirect: "follow",
+            signal: AbortSignal.timeout(15000),
+        });
+    }
+    catch (e) {
+        throw new HtmlmetaError(`Could not fetch ${url}: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    if (!res.ok)
+        throw new HtmlmetaError(`HTTP ${res.status} from ${url}`);
+    const html = (await res.text()).slice(0, 400000);
+    const title = attr(html, "og:title") ?? first(html, /<title[^>]*>([^<]*)<\/title>/i) ?? "no title";
+    const description = attr(html, "og:description") ?? attr(html, "description") ?? "no description";
+    const image = attr(html, "og:image");
+    const site = attr(html, "og:site_name");
+    const type = attr(html, "og:type");
+    const canonical = first(html, /<link[^>]*rel="canonical"[^>]*href="([^"]*)"/i);
+    const author = attr(html, "author");
+    const published = attr(html, "article:published_time");
+    const lines = [
+        `URL: ${url}`,
+        `Title: ${title.slice(0, 200)}`,
+        `Description: ${description.slice(0, 300)}`,
+    ];
+    if (site)
+        lines.push(`Site: ${site}`);
+    if (type)
+        lines.push(`Type: ${type}`);
+    if (image)
+        lines.push(`Image: ${image}`);
+    if (canonical)
+        lines.push(`Canonical: ${canonical}`);
+    if (author)
+        lines.push(`Author: ${author}`);
+    if (published)
+        lines.push(`Published: ${published.slice(0, 10)}`);
+    return lines.join("\n");
+}

package/dist/index.js

@@ -0,0 +1,4 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+const main = async () => { const server = createServer(); await server.connect(new StdioServerTransport()); };
+main().catch((error) => { console.error("Fatal error:", error); process.exit(1); });

package/dist/server.js

@@ -0,0 +1,24 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { meta } 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 };
+const error = (e) => `Error: ${e instanceof Error ? e.message : String(e)}`;
+export function createServer() {
+    const server = new McpServer({ name: "html-meta-mcp", version: "1.0.0" });
+    server.registerTool("meta", {
+        title: "Meta",
+        description: "Meta and open graph tags for a URL.",
+        inputSchema: z.object({ url: z.string().describe("URL to inspect.") }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await meta(args));
+        }
+        catch (e) {
+            return textError(error(e));
+        }
+    });
+    return server;
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "version": "1.0.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mrfentmen/html-meta-mcp.git"
+  },
+  "bin": {
+    "html-meta-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "server.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "dev": "npm run build && node dist/index.js"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "name": "html-meta-mcp",
+  "description": "Fetch title, description, and open graph tags from a web page. No key required.",
+  "mcpName": "io.github.mrfentmen/html-meta-mcp",
+  "keywords": [
+    "mcp",
+    "metadata",
+    "opengraph",
+    "preview",
+    "web"
+  ],
+  "engines": {
+    "node": ">=20"
+  }
+}

package/server.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.mrfentmen/html-meta-mcp",
+  "description": "Fetch title, description, and open graph tags from a web page. No key required.",
+  "repository": {
+    "url": "https://github.com/mrfentmen/html-meta-mcp",
+    "source": "github"
+  },
+  "version": "1.0.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "html-meta-mcp",
+      "version": "1.0.0",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}