@hoagsmedia/frugr-mcp 0.2.0

package/README.md

@@ -0,0 +1,22 @@
+# @hoagsmedia/frugr-mcp
+
+Preferred npm name for the frugr **read-only** MCP stdio bridge.
+
+This package is identical to [`@hoagsmedia/frgur-mcp-server`](https://www.npmjs.com/package/@hoagsmedia/frgur-mcp-server) v0.2.0 — same `index.mjs`, same env vars (`FRGUR_API_TOKEN`, `FRGUR_API_URL`). The legacy `frgur` spelling remains for backward compatibility.
+
+Full setup, tool list, and security notes: [mcp-server README on GitHub](https://github.com/hoagsmedia/frugr/blob/main/mcp-server/README.md) or the [`frgur-mcp-server` npm page](https://www.npmjs.com/package/@hoagsmedia/frgur-mcp-server).
+
+```json
+{
+	"mcpServers": {
+		"frugr": {
+			"command": "npx",
+			"args": ["-y", "@hoagsmedia/frugr-mcp@0.2.0"],
+			"env": {
+				"FRGUR_API_URL": "https://app.frgur.com",
+				"FRGUR_API_TOKEN": "frgur_pat_your_token_here"
+			}
+		}
+	}
+}
+```

package/index.mjs

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+// @hoagsmedia/frgur-mcp-server — a thin, READ-ONLY MCP bridge to your frugr books.
+//
+// It exposes frugr's books tools over stdio (for Cursor / Claude Desktop /
+// Claude Code / ChatGPT) and forwards every call to the frugr API using your
+// Personal Access Token. The bridge holds no credentials of its own, runs your
+// own AI client's model (not frugr's), and can only read — it never writes.
+//
+// Config (env):
+//   FRGUR_API_TOKEN  required — a token from frugr → Settings → External AI apps
+//   FRGUR_API_URL    optional — your frugr origin (default https://app.frgur.com)
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const PKG = JSON.parse(
+	readFileSync(join(dirname(fileURLToPath(import.meta.url)), 'package.json'), 'utf8')
+);
+
+const API_URL = (process.env.FRGUR_API_URL ?? 'https://app.frgur.com').replace(/\/+$/, '');
+const API_TOKEN = process.env.FRGUR_API_TOKEN ?? '';
+const ENDPOINT = `${API_URL}/api/mcp`;
+
+// Diagnostics MUST go to stderr — stdout is the MCP protocol channel.
+function logErr(msg) {
+	process.stderr.write(`[frgur-mcp] ${msg}\n`);
+}
+
+if (!API_TOKEN) {
+	logErr('FRGUR_API_TOKEN is required. Create one in frugr → Settings → External AI apps (MCP).');
+	process.exit(1);
+}
+
+/** POST one bridge request to the frugr endpoint, authenticated by the PAT. */
+async function call(method, params) {
+	let res;
+	try {
+		res = await fetch(ENDPOINT, {
+			method: 'POST',
+			headers: { 'content-type': 'application/json', authorization: `Bearer ${API_TOKEN}` },
+			body: JSON.stringify({ method, params })
+		});
+	} catch (e) {
+		throw new Error(`Could not reach frugr at ${ENDPOINT}: ${e?.message ?? e}`, { cause: e });
+	}
+	const text = await res.text();
+	let data;
+	try {
+		data = text ? JSON.parse(text) : {};
+	} catch {
+		data = { error: text };
+	}
+	if (!res.ok) throw new Error(data?.error ?? `frugr API error ${res.status}`);
+	return data;
+}
+
+const server = new Server(
+	{ name: 'frgur-books', version: PKG.version },
+	{ capabilities: { tools: {} } }
+);
+
+// Tool list comes straight from frugr, so adding a tool server-side surfaces it
+// to every client with no package update.
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+	const { tools } = await call('tools/list');
+	return { tools: tools ?? [] };
+});
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+	const { name, arguments: args } = request.params;
+	const result = await call('tools/call', { name, arguments: args ?? {} });
+	// frugr already returns an MCP CallTool result ({ content, isError }); pass it
+	// through, falling back to stringifying anything unexpected.
+	return {
+		content: result.content ?? [{ type: 'text', text: JSON.stringify(result) }],
+		isError: Boolean(result.isError)
+	};
+});
+
+await server.connect(new StdioServerTransport());
+logErr(`connected to ${API_URL} — read-only books tools available.`);

package/package.json

@@ -0,0 +1,29 @@
+{
+	"name": "@hoagsmedia/frugr-mcp",
+	"version": "0.2.0",
+	"description": "Read-only MCP bridge to your frugr books (12 tools). Preferred npm name — alias of @hoagsmedia/frgur-mcp-server.",
+	"type": "module",
+	"bin": {
+		"frugr-mcp": "index.mjs"
+	},
+	"files": [
+		"index.mjs",
+		"README.md"
+	],
+	"engines": {
+		"node": ">=18"
+	},
+	"license": "MIT",
+	"publishConfig": {
+		"access": "public"
+	},
+	"dependencies": {
+		"@modelcontextprotocol/sdk": "^1.29.0"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/hoagsmedia/frugr.git",
+		"directory": "mcp-server/frugr-alias"
+	},
+	"homepage": "https://github.com/hoagsmedia/frugr/tree/main/mcp-server#mcp-stdio-bridge"
+}