@powerfm/libretime-mcp 0.1.5 → 0.1.8

package/README.md

@@ -16,7 +16,7 @@ Tools are organised into subdirectories under `src/tools/` — one file per tool
 - `get_stream_state` — current on-air state
 
 **Analytics (admin)**
-- `get_listener_counts` — listener stats by mount point
+- ~~`get_listener_counts`~~ — disabled (API returns full history with no filtering, ~120k records)
 - `get_playout_history` — recent playout history with track metadata
 
 **Media library (admin)**
@@ -86,14 +86,17 @@ Clone the repo, create a `.env` file with your credentials (see [Development](#d
   "mcpServers": {
     "libretime": {
       "command": "node",
-      "args": ["/absolute/path/to/libretime-mcp/dist/stdio/admin.js"]
+      "args": ["/absolute/path/to/libretime-mcp/dist/stdio/admin.js"],
+      "env": {
+        "LIBRETIME_URL": "https://your-instance.example.com",
+        "LIBRETIME_USER": "user",
+        "LIBRETIME_PASS": "pass"
+      }
     }
   }
 }
 ```
 
-No `env` block needed — credentials are loaded automatically from `.env`.
-
 ## Option 2 — Self-hosted HTTP server
 
 Best for advanced setups — connect any MCP-compatible client over the network.
@@ -110,6 +113,7 @@ LIBRETIME_USER=your_api_username
 LIBRETIME_PASS=your_api_password
 MCP_API_KEY=your_secret_api_key     # clients must send this as a Bearer token
 MCP_PORT=3000                        # optional, defaults to 3000 (admin) / 3001 (client)
+CORS_ORIGIN=https://your-app.example.com  # optional, lock CORS to a specific origin (default: reflect any)
 ```
 
 Generate a random API key:

package/dist/http/admin.js

@@ -3,11 +3,12 @@
 // Exposes POST /mcp using MCP Streamable HTTP transport.
 // Requires Authorization: Bearer <MCP_API_KEY> on every request.
 // Intended for network clients (e.g. powerfm-agent). For Claude Desktop use stdio/admin.ts.
-import './env.js';
+import '../env.js';
 import { createRequire } from 'module';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import { createMcpExpressApp } from '@modelcontextprotocol/sdk/server/express.js';
+import cors from 'cors';
 const { version } = createRequire(import.meta.url)('../../package.json');
 import { register as registerShows } from '../tools/shows/index.js';
 import { register as registerAnalytics } from '../tools/analytics/index.js';
@@ -19,6 +20,7 @@ if (!API_KEY) {
     process.exit(1);
 }
 const app = createMcpExpressApp({ host: '0.0.0.0' });
+app.use(cors({ origin: process.env.CORS_ORIGIN ?? true, credentials: true }));
 // Simple API key middleware — checks Authorization: Bearer <key>
 app.use('/mcp', (req, res, next) => {
     const auth = req.headers['authorization'];
@@ -30,7 +32,7 @@ app.use('/mcp', (req, res, next) => {
 });
 // Stateless transport — a fresh McpServer per request keeps things simple
 // and avoids session management complexity for now
-app.post('/mcp', async (req, res) => {
+app.all('/mcp', async (req, res) => {
     const server = new McpServer({ name: 'libretime-mcp-admin', version });
     registerShows(server);
     registerAnalytics(server);

package/dist/http/client.js

@@ -3,11 +3,12 @@
 // Exposes POST /mcp using MCP Streamable HTTP transport.
 // Requires Authorization: Bearer <MCP_API_KEY> on every request.
 // Intended for network clients. For Claude Desktop use stdio/client.ts.
-import './env.js';
+import '../env.js';
 import { createRequire } from 'module';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import { createMcpExpressApp } from '@modelcontextprotocol/sdk/server/express.js';
+import cors from 'cors';
 import { register as registerShows } from '../tools/shows/index.js';
 const { version } = createRequire(import.meta.url)('../../package.json');
 const PORT = parseInt(process.env.MCP_PORT ?? '3001', 10);
@@ -17,6 +18,7 @@ if (!API_KEY) {
     process.exit(1);
 }
 const app = createMcpExpressApp({ host: '0.0.0.0' });
+app.use(cors({ origin: process.env.CORS_ORIGIN ?? true, credentials: true }));
 // Simple API key middleware — checks Authorization: Bearer <key>
 app.use('/mcp', (req, res, next) => {
     const auth = req.headers['authorization'];
@@ -28,7 +30,7 @@ app.use('/mcp', (req, res, next) => {
 });
 // Stateless transport — a fresh McpServer per request keeps things simple
 // and avoids session management complexity for now
-app.post('/mcp', async (req, res) => {
+app.all('/mcp', async (req, res) => {
     const server = new McpServer({ name: 'libretime-mcp-client', version });
     registerShows(server);
     const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });

package/dist/stdio/admin.js

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-import './env.js';
 import { createRequire } from 'module';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

package/dist/stdio/client.js

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-import './env.js';
 import { createRequire } from 'module';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

package/dist/tools/admin/get_users.js

@@ -8,8 +8,8 @@ export function register(server) {
     }, async () => {
         const raw = await libreGet('/api/v2/users');
         const users = z.array(UserSchema).parse(raw);
-        const trimmed = users.map(({ id, username, first_name, last_name, email, type }) => ({
-            id, username, first_name, last_name, email, role: type,
+        const trimmed = users.map(({ id, username, first_name, last_name, email, role }) => ({
+            id, username, first_name, last_name, email, role,
         }));
         return toolText(trimmed);
     });

package/dist/tools/admin/types.js

@@ -5,7 +5,7 @@ export const UserSchema = z.object({
     first_name: z.string(),
     last_name: z.string(),
     email: z.string(),
-    type: z.string(),
+    role: z.string(),
 });
 export const ShowHostSchema = z.object({
     id: z.number(),

package/dist/tools/analytics/get_listener_counts.js

@@ -4,8 +4,11 @@ import { toolText } from '../../tool-response.js';
 import { ListenerCountSchema, MountNameSchema } from './types.js';
 export function register(server) {
     server.registerTool('get_listener_counts', {
-        description: 'Get listener count history for PowerFM streams. Returns counts per mount point (stream URL) with timestamps. Useful for understanding peak listening times and audience size.',
-    }, async () => {
+        description: 'Get listener count history for PowerFM streams. Returns the most recent entries per mount point with timestamps. Useful for understanding peak listening times and audience size.',
+        inputSchema: {
+            limit: z.number().int().min(1).max(500).default(100).describe('Number of most recent entries to return (default 100, max 500)'),
+        },
+    }, async ({ limit }) => {
         const [rawCounts, rawMounts] = await Promise.all([
             libreGet('/api/v2/listener-counts'),
             libreGet('/api/v2/mount-names'),
@@ -13,7 +16,9 @@ export function register(server) {
         const counts = z.array(ListenerCountSchema).parse(rawCounts);
         const mounts = z.array(MountNameSchema).parse(rawMounts);
         const mountMap = new Map(mounts.map((m) => [m.id, m.mount_name]));
-        const enriched = counts.map(({ id, listener_count, timestamp, mount_name }) => ({
+        const enriched = counts
+            .slice(-limit)
+            .map(({ id, listener_count, timestamp, mount_name }) => ({
             id,
             listener_count,
             timestamp,

package/dist/tools/analytics/get_playout_history.js

@@ -19,8 +19,10 @@ export function register(server) {
         const history = z.array(PlayoutHistorySchema).parse(rawHistory);
         // Collect unique file IDs then fetch metadata in parallel
         const fileIds = [...new Set(history.map((h) => h.file).filter((id) => id !== null))];
-        const rawFiles = await Promise.all(fileIds.map((id) => libreGet(`/api/v2/files/${id}`)));
-        const files = rawFiles.map((f) => FileMetadataSchema.parse(f));
+        const rawFiles = await Promise.allSettled(fileIds.map((id) => libreGet(`/api/v2/files/${id}`)));
+        const files = rawFiles
+            .map((r) => r.status === 'fulfilled' ? FileMetadataSchema.safeParse(r.value) : null)
+            .flatMap((r) => (r?.success ? [r.data] : []));
         const fileMap = new Map(files.map((f) => [f.id, f]));
         const enriched = history.map(({ id, starts, ends, file, instance }) => {
             const meta = file !== null ? fileMap.get(file) : undefined;

package/dist/tools/analytics/index.js

@@ -1,6 +1,4 @@
-import { register as registerGetListenerCounts } from './get_listener_counts.js';
 import { register as registerGetPlayoutHistory } from './get_playout_history.js';
 export function register(server) {
-    registerGetListenerCounts(server);
     registerGetPlayoutHistory(server);
 }

package/dist/tools/shows/types.js

@@ -8,12 +8,17 @@ export const ShowSchema = z.object({
 });
 export const ScheduleItemSchema = z.object({
     id: z.number(),
-    starts: z.string(),
-    ends: z.string(),
-    show_id: z.number(),
-    show_name: z.string(),
+    starts_at: z.string(),
+    ends_at: z.string(),
+    instance: z.number(),
+    file: z.number().nullable(),
     broadcasted: z.number(),
-});
-export const StreamStateSchema = z.object({
-    source_enabled: z.boolean(),
+    played: z.boolean(),
 }).passthrough();
+export const StreamStateSchema = z.object({
+    input_main_connected: z.boolean(),
+    input_main_streaming: z.boolean(),
+    input_show_connected: z.boolean(),
+    input_show_streaming: z.boolean(),
+    schedule_streaming: z.boolean(),
+});

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@powerfm/libretime-mcp",
-  "version": "0.1.5",
+  "version": "0.1.8",
   "private": false,
   "type": "module",
+  "license": "GPL-3.0",
   "description": "MCP server for LibreTime radio station — connect Claude to your broadcast schedule, media library, and analytics",
   "repository": {
     "type": "git",
@@ -20,13 +21,13 @@
     "README.md"
   ],
   "scripts": {
-    "dev:client": "tsx --env-file=.env watch src/stdio/client.ts",
-    "dev:admin": "tsx --env-file=.env watch src/stdio/admin.ts",
-    "dev:client-http": "tsx --env-file=.env watch src/http/client.ts",
-    "dev:admin-http": "tsx --env-file=.env watch src/http/admin.ts",
+    "dev:client": "tsx watch --env-file=.env src/stdio/client.ts",
+    "dev:admin": "tsx watch --env-file=.env src/stdio/admin.ts",
+    "dev:client-http": "tsx watch --env-file=.env src/http/client.ts",
+    "dev:admin-http": "tsx watch --env-file=.env src/http/admin.ts",
     "clean": "rm -rf dist",
     "build": "npm run clean && tsc",
-    "prepublishOnly": "npm run build",
+    "prepublishOnly": "npm run build && npm test",
     "publish:patch": "npm version patch && npm publish --access public",
     "publish:minor": "npm version minor && npm publish --access public",
     "start:client": "node --env-file=.env dist/stdio/client.js",
@@ -34,15 +35,21 @@
     "start:client-http": "node --env-file=.env dist/http/client.js",
     "start:admin-http": "node --env-file=.env dist/http/admin.js",
     "generate:key": "node -e \"console.log(require('crypto').randomBytes(32).toString('hex'))\"",
+    "inspect:client": "npx @modelcontextprotocol/inspector tsx --env-file=.env src/stdio/client.ts",
+    "inspect:admin": "npx @modelcontextprotocol/inspector tsx --env-file=.env src/stdio/admin.ts",
+    "inspect:admin-http": "npx @modelcontextprotocol/inspector --transport http --server-url http://localhost:3000/mcp --header \"Authorization: Bearer $MCP_API_KEY\"",
+    "inspect:client-http": "npx @modelcontextprotocol/inspector --transport http --server-url http://localhost:3001/mcp --header \"Authorization: Bearer $MCP_API_KEY\"",
     "test": "vitest run",
     "test:watch": "vitest"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
+    "cors": "~2.8.6",
     "express": "~5.2.1",
     "zod": "^3.23.8"
   },
   "devDependencies": {
+    "@types/cors": "~2.8.19",
     "@types/express": "~5.0.6",
     "@types/node": "^22.0.0",
     "tsx": "^4.19.0",