@powerfm/libretime-mcp 0.1.4 → 0.1.5

package/README.md

@@ -33,12 +33,13 @@ Tools are organised into subdirectories under `src/tools/` — one file per tool
 
 No hosting required. Claude Desktop spawns the server as a subprocess and manages its lifecycle.
 
-**Install:**
+### Global install
+
 ```bash
 npm install -g @powerfm/libretime-mcp
 ```
 
-**Add to** `~/Library/Application Support/Claude/claude_desktop_config.json`:
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 
 ```json
 {
@@ -58,7 +59,7 @@ npm install -g @powerfm/libretime-mcp
 
 Use `libretime-mcp-client` instead of `libretime-mcp` for read-only access.
 
-Or run without installing (npx fetches on first use):
+### npx (no install)
 
 ```json
 {
@@ -76,6 +77,23 @@ Or run without installing (npx fetches on first use):
 }
 ```
 
+### From source
+
+Clone the repo, create a `.env` file with your credentials (see [Development](#development) below), then point Claude Desktop at the local build:
+
+```json
+{
+  "mcpServers": {
+    "libretime": {
+      "command": "node",
+      "args": ["/absolute/path/to/libretime-mcp/dist/stdio/admin.js"]
+    }
+  }
+}
+```
+
+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.

package/dist/http/admin.js

@@ -3,6 +3,7 @@
 // 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 { createRequire } from 'module';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';

package/dist/http/client.js

@@ -3,6 +3,7 @@
 // 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 { createRequire } from 'module';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';

package/dist/stdio/admin.js

@@ -1,4 +1,5 @@
 #!/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,4 +1,5 @@
 #!/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerfm/libretime-mcp",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "private": false,
   "type": "module",
   "description": "MCP server for LibreTime radio station — connect Claude to your broadcast schedule, media library, and analytics",