@mrfentmen/rss-mcp 1.0.0

package/README.md

@@ -0,0 +1,19 @@
+# Rss MCP
+
+RSS in one place: direct feed parsing and rss2json conversion for any feed URL. 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
+
+* `readFeed`  Fetch and parse any RSS or Atom feed.
+* `feedJson`  Convert any feed to JSON via rss2json.
+
+## Usage
+
+```bash
+npm install
+npm run build
+node dist/index.js
+```
+

package/dist/api.js

@@ -0,0 +1,73 @@
+const RSS2JSON_BASE = 'https://api.rss2json.com/v1/api.json';
+const UA = 'mrfentmen-rss-mcp/1.0 (https://github.com/mrfentmen)';
+export class RssError extends Error {
+}
+function strip(s) {
+    return s
+        .replace(/<[^>]*>/g, ' ')
+        .replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&amp;/g, '&')
+        .replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&apos;/g, "'")
+        .replace(/\s+/g, ' ').trim();
+}
+function parseFeed(xml) {
+    const out = [];
+    const atomRe = /<entry>([\s\S]*?)<\/entry>/g;
+    let m;
+    while ((m = atomRe.exec(xml)) !== null) {
+        const e = m[1];
+        const title = /<title[^>]*>([\s\S]*?)<\/title>/.exec(e)?.[1] ?? '';
+        const link = /<link[^>]*href="([^"]+)"/.exec(e)?.[1] ?? '';
+        const pub = /<updated[^>]*>([\s\S]*?)<\/updated>/.exec(e)?.[1] ?? /<published[^>]*>([\s\S]*?)<\/published>/.exec(e)?.[1] ?? '';
+        if (title)
+            out.push({ title: strip(title), link, pub: strip(pub).slice(0, 10) });
+    }
+    const rssRe = /<item>([\s\S]*?)<\/item>/g;
+    while ((m = rssRe.exec(xml)) !== null) {
+        const e = m[1];
+        const title = /<title[^>]*>([\s\S]*?)<\/title>/.exec(e)?.[1] ?? '';
+        const link = /<link[^>]*>([\s\S]*?)<\/link>/.exec(e)?.[1] ?? '';
+        const pub = /<pubDate[^>]*>([\s\S]*?)<\/pubDate>/.exec(e)?.[1] ?? '';
+        if (title)
+            out.push({ title: strip(title), link: strip(link), pub: strip(pub).slice(0, 16) });
+    }
+    return out;
+}
+export async function readFeed(args) {
+    const url = (args.url ?? '').trim();
+    if (!/^https?:\/\//i.test(url))
+        throw new RssError('Provide a full http or https feed URL');
+    const limit = Math.min(args.limit ?? 10, 25);
+    const res = await fetch(url, {
+        headers: { 'User-Agent': UA, Accept: 'application/rss+xml, application/atom+xml, application/xml, text/xml' },
+        redirect: 'follow',
+        signal: AbortSignal.timeout(25000),
+    });
+    if (!res.ok)
+        throw new RssError(`Feed error ${res.status}`);
+    const text = await res.text();
+    const title = /<title[^>]*>([\s\S]*?)<\/title>/.exec(text)?.[1] ?? '';
+    const entries = parseFeed(text).slice(0, limit);
+    return `${strip(title) || 'Feed'}\n${entries.map((e, i) => `${i + 1}. ${e.title}\n   ${e.pub ? `${e.pub} | ` : ''}${e.link}`).join('\n') || 'No entries found'}`;
+}
+export async function feedJson(args) {
+    const url = (args.url ?? '').trim();
+    if (!url)
+        return 'Provide an RSS feed URL.';
+    const limit = Math.max(1, Math.min(args.limit ?? 10, 30));
+    const res = await fetch(`${RSS2JSON_BASE}?rss_url=${encodeURIComponent(url)}`, {
+        headers: { 'User-Agent': UA, Accept: 'application/json' },
+        signal: AbortSignal.timeout(25000),
+    });
+    if (!res.ok)
+        throw new RssError(`RSS2JSON returned ${res.status}`);
+    const data = (await res.json());
+    if (data.status !== 'ok')
+        throw new RssError(`RSS2JSON error: ${data.message ?? data.status ?? 'unknown'}`);
+    const items = (data.items ?? []).slice(0, limit);
+    if (!items.length)
+        return 'The feed returned no items.';
+    return `Feed: ${data.feed?.title ?? url} (${items.length} items):\n` +
+        items
+            .map((item, i) => `${i + 1}. ${item.title ?? 'untitled'} | ${(item.pubDate ?? '').slice(0, 16)}${item.link ? `\n   ${item.link}` : ''}`)
+            .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,37 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { readFeed, feedJson } 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: 'rss-mcp', version: '1.0.0' });
+    server.registerTool('readFeed', {
+        title: "Read Feed",
+        description: 'Fetch and parse any RSS or Atom feed directly.',
+        inputSchema: z.object({ url: z.string().describe('Feed URL.').optional(), limit: z.number().describe('Max entries.').optional() }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await readFeed(args));
+        }
+        catch (e) {
+            return textError(error(e));
+        }
+    });
+    server.registerTool('feedJson', {
+        title: "Feed Json",
+        description: 'Convert any RSS feed to JSON via rss2json.',
+        inputSchema: z.object({ url: z.string().describe('Feed URL.').optional(), limit: z.number().describe('Max entries.').optional() }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await feedJson(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/rss-mcp.git"
+  },
+  "bin": {
+    "rss-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": "@mrfentmen/rss-mcp",
+  "description": "RSS in one place: direct feed parsing and rss2json conversion for any feed URL. No key required.",
+  "mcpName": "io.github.mrfentmen/rss-mcp",
+  "keywords": [
+    "mcp",
+    "rss",
+    "atom",
+    "feeds",
+    "news"
+  ],
+  "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/rss-mcp",
+  "description": "RSS in one place: direct feed parsing and rss2json conversion for any feed URL. No key required.",
+  "repository": {
+    "url": "https://github.com/mrfentmen/rss-mcp",
+    "source": "github"
+  },
+  "version": "1.0.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@mrfentmen/rss-mcp",
+      "version": "1.0.0",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}