@withpica/mcp-server-directory 1.0.0

package/dist/client.d.ts

@@ -0,0 +1,12 @@
+export interface DirectoryClientConfig {
+    baseUrl: string;
+    debug?: boolean;
+}
+export declare class DirectoryClient {
+    private baseUrl;
+    private debug;
+    constructor(config: DirectoryClientConfig);
+    private fetchWithTimeout;
+    request<T>(path: string, params?: Record<string, string>): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAU;gBAEX,MAAM,EAAE,qBAAqB;YAK3B,gBAAgB;IAmBxB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAgF5E"}

package/dist/client.js

@@ -0,0 +1,92 @@
+const DEFAULT_TIMEOUT_MS = 15_000;
+const MAX_RETRIES = 2;
+const RETRY_BASE_MS = 500;
+function isRetryableStatus(status) {
+    return status === 429 || status === 502 || status === 503 || status === 504;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export class DirectoryClient {
+    baseUrl;
+    debug;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, "");
+        this.debug = config.debug || false;
+    }
+    async fetchWithTimeout(url, init, timeoutMs) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            return await fetch(url, { ...init, signal: controller.signal });
+        }
+        catch (err) {
+            if (err.name === "AbortError") {
+                throw new Error(`Request timed out after ${timeoutMs}ms: GET ${url}`);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async request(path, params) {
+        const url = new URL(`${this.baseUrl}/api/public/directory${path}`);
+        if (params) {
+            Object.entries(params).forEach(([key, value]) => {
+                if (value !== undefined && value !== "") {
+                    url.searchParams.set(key, value);
+                }
+            });
+        }
+        if (this.debug) {
+            console.error(`[Directory MCP] GET ${url.toString()} (timeout: ${DEFAULT_TIMEOUT_MS}ms)`);
+        }
+        let lastError;
+        for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+            try {
+                const response = await this.fetchWithTimeout(url.toString(), { method: "GET", headers: { Accept: "application/json" } }, DEFAULT_TIMEOUT_MS);
+                if (response.ok) {
+                    const json = await response.json();
+                    if (json.success === false) {
+                        throw new Error(json.error || "API returned unsuccessful response");
+                    }
+                    return json;
+                }
+                const errorText = await response.text();
+                // Auth errors — fail fast, never retry
+                if (response.status === 401 || response.status === 403) {
+                    throw new Error(`Authentication failed: ${response.status} ${errorText}`);
+                }
+                if (isRetryableStatus(response.status) && attempt < MAX_RETRIES) {
+                    const retryAfter = response.headers.get("retry-after");
+                    const parsed = retryAfter ? parseInt(retryAfter, 10) : NaN;
+                    const delayMs = !isNaN(parsed)
+                        ? parsed * 1000
+                        : RETRY_BASE_MS * Math.pow(2, attempt);
+                    if (this.debug) {
+                        console.error(`[Directory MCP] ${response.status} on attempt ${attempt + 1}, retrying in ${delayMs}ms`);
+                    }
+                    await sleep(delayMs);
+                    continue;
+                }
+                throw new Error(`API request failed: ${response.status} ${errorText}`);
+            }
+            catch (err) {
+                lastError = err;
+                if (err.message?.includes("timed out") &&
+                    attempt < MAX_RETRIES) {
+                    const delayMs = RETRY_BASE_MS * Math.pow(2, attempt);
+                    if (this.debug) {
+                        console.error(`[Directory MCP] timeout on attempt ${attempt + 1}, retrying in ${delayMs}ms`);
+                    }
+                    await sleep(delayMs);
+                    continue;
+                }
+                throw err;
+            }
+        }
+        throw lastError || new Error("Request failed after retries");
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+export interface ServerConfig {
+    directoryUrl: string;
+    serverName: string;
+    version: string;
+    debug: boolean;
+}
+export declare function loadConfig(): ServerConfig;
+export declare function validateConfig(config: ServerConfig): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,UAAU,IAAI,YAAY,CAOzC;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAIzD"}

package/dist/config.js

@@ -0,0 +1,14 @@
+export function loadConfig() {
+    return {
+        directoryUrl: process.env.PICA_DIRECTORY_URL || "https://withpica.com",
+        serverName: "pica-directory-mcp-server",
+        version: "1.0.0",
+        debug: process.env.DEBUG === "true" || process.env.DEBUG === "1",
+    };
+}
+export function validateConfig(config) {
+    if (!config.directoryUrl || !config.directoryUrl.startsWith("http")) {
+        throw new Error("Invalid PICA_DIRECTORY_URL");
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,sBAAsB;QACtE,UAAU,EAAE,2BAA2B;QACvC,OAAO,EAAE,OAAO;QAChB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,GAAG;KACjE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { loadConfig, validateConfig } from "./config.js";
+import { DirectoryMcpServer } from "./server.js";
+async function main() {
+    try {
+        const config = loadConfig();
+        validateConfig(config);
+        const server = new DirectoryMcpServer(config);
+        await server.start();
+        process.on("SIGINT", async () => {
+            console.error("[Directory MCP] Shutting down...");
+            await server.stop();
+            process.exit(0);
+        });
+        process.on("SIGTERM", async () => {
+            console.error("[Directory MCP] Shutting down...");
+            await server.stop();
+            process.exit(0);
+        });
+    }
+    catch (error) {
+        console.error("[Directory MCP] Fatal error:", error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,cAAc,CAAC,MAAM,CAAC,CAAC;QAEvB,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QAErB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YAC9B,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;YAClD,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;YAC/B,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;YAClD,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,8BAA8B,EAC9B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Prompt Registry for Directory MCP Server
+ * Guided workflows for music discovery, sync licensing, and rights research
+ */
+export interface PromptDefinition {
+    name: string;
+    description: string;
+    arguments?: Array<{
+        name: string;
+        description: string;
+        required?: boolean;
+    }>;
+}
+export interface PromptMessage {
+    role: "user" | "assistant";
+    content: {
+        type: string;
+        text: string;
+    };
+}
+export interface PromptResult {
+    messages: PromptMessage[];
+    [key: string]: unknown;
+}
+export declare class PromptRegistry {
+    listPrompts(): PromptDefinition[];
+    getPrompt(name: string, args?: Record<string, any>): Promise<PromptResult>;
+    private getFindMusicPrompt;
+    private getResearchCreatorPrompt;
+    private getDirectoryAutopilotPrompt;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,cAAc;IACzB,WAAW,IAAI,gBAAgB,EAAE;IAoC3B,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACzB,OAAO,CAAC,YAAY,CAAC;IAaxB,OAAO,CAAC,kBAAkB;IA6C1B,OAAO,CAAC,wBAAwB;IAwChC,OAAO,CAAC,2BAA2B;CAqCpC"}

package/dist/prompts/index.js

@@ -0,0 +1,168 @@
+/**
+ * Prompt Registry for Directory MCP Server
+ * Guided workflows for music discovery, sync licensing, and rights research
+ */
+export class PromptRegistry {
+    listPrompts() {
+        return [
+            {
+                name: "find-music",
+                description: "Find music for a sync brief, playlist, or project — search by mood, BPM, key, energy, or description",
+                arguments: [
+                    {
+                        name: "brief",
+                        description: "What you're looking for — a mood, scene description, or audio characteristics",
+                        required: false,
+                    },
+                ],
+            },
+            {
+                name: "research-creator",
+                description: "Research a songwriter, composer, or performer — see their works, identifiers, collaborators, and verification status",
+                arguments: [
+                    {
+                        name: "name_or_id",
+                        description: "Creator name, IPI number, ISNI, or MusicBrainz ID",
+                        required: false,
+                    },
+                ],
+            },
+            {
+                name: "directory-autopilot",
+                description: "Not sure where to start? Describe what you need and get routed to the right workflow — sync search, rights research, or identifier lookup",
+                arguments: [],
+            },
+        ];
+    }
+    async getPrompt(name, args) {
+        switch (name) {
+            case "find-music":
+                return this.getFindMusicPrompt(args?.brief);
+            case "research-creator":
+                return this.getResearchCreatorPrompt(args?.name_or_id);
+            case "directory-autopilot":
+                return this.getDirectoryAutopilotPrompt();
+            default:
+                throw new Error(`Prompt not found: ${name}`);
+        }
+    }
+    getFindMusicPrompt(brief) {
+        const briefInstruction = brief
+            ? `The user is looking for: "${brief}". Translate this into audio search parameters.`
+            : `Ask me what I'm looking for — a mood, a scene, a vibe, or specific audio characteristics (BPM, key, energy).`;
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Help me find music in the PICA public directory for a sync brief or project.
+
+${briefInstruction}
+
+Workflow:
+1. Translate the brief into search parameters for directory_search_recordings:
+   - Mood descriptions → energy, danceability, key_mode, mood filters
+   - "Upbeat" → min_energy: 0.6, min_danceability: 0.5
+   - "Dark/moody" → max_energy: 0.4, key_mode: minor
+   - "Chill" → max_energy: 0.4, max_bpm: 100
+   - Specific requests → use BPM, key, duration filters directly
+
+2. Run directory_search_recordings with the parameters.
+
+3. For each promising result, use directory_lookup_work_full to get:
+   - Who wrote it (credits with IPI numbers)
+   - Whether credits are attested (verified ownership)
+   - DSP links (Spotify, Apple Music — so the user can listen)
+   - Registration score (higher = cleaner rights chain)
+
+4. Present results as a shortlist with:
+   - Title, artist, BPM, key, energy
+   - Credits summary (who to contact for licensing)
+   - Any flags (unattested credits, low registration score, missing ISRC)
+
+If no results match, suggest broadening the search (wider BPM range, drop key filter, etc.).
+
+Important: This is a public directory — only works from organisations that opted in are visible. If the catalog is small, say so.`,
+                    },
+                },
+            ],
+        };
+    }
+    getResearchCreatorPrompt(nameOrId) {
+        const searchInstruction = nameOrId
+            ? `Look up: "${nameOrId}". Try directory_lookup_person_full first (it accepts name, IPI, ISNI, or MusicBrainz ID). If that doesn't match, use directory_list_people with a text search.`
+            : `Ask me for the creator's name, IPI number, ISNI, or MusicBrainz ID.`;
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Help me research a music creator in the PICA public directory.
+
+${searchInstruction}
+
+Once you find the person, use directory_lookup_person_full to get their complete profile:
+- Identifiers (IPI, ISNI, MusicBrainz) — essential for rights verification
+- All credited works with roles (writer, composer, performer, producer)
+- Collaborator network — who they work with
+- Verification score — how complete their profile is
+
+Then for their most notable works (up to 5), use directory_lookup_work_full to get:
+- Full credits and splits (are they the sole writer or one of many?)
+- Recordings with ISRCs
+- Audio analysis (BPM, key, energy)
+- DSP links and registration status
+
+Present a summary:
+- Creator profile (name, identifiers, role patterns)
+- Catalog overview (how many works, typical roles, common collaborators)
+- Notable works with credit details
+- Any gaps (missing identifiers, unattested credits, low scores)
+
+This is useful for: rights research, due diligence before licensing, publisher evaluation, or understanding a catalog before acquisition.`,
+                    },
+                },
+            ],
+        };
+    }
+    getDirectoryAutopilotPrompt() {
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `You've connected to the PICA public music directory. Help me find what I need.
+
+First, read the llms://primer resource to understand what's available.
+
+Then ask me what I'm looking for. Based on my answer, route to the right workflow:
+
+If I'm looking for MUSIC FOR A PROJECT (sync brief, playlist, mood search):
+→ Use the find-music workflow. Translate my description into audio search parameters and search recordings by BPM, key, energy, mood. Then look up full details on promising matches.
+
+If I'm looking for INFORMATION ABOUT A CREATOR (songwriter, composer, performer):
+→ Use the research-creator workflow. Look up their profile, works, identifiers, and collaborators.
+
+If I have a SPECIFIC IDENTIFIER to resolve (ISRC, ISWC, IPI, ISNI):
+→ Route directly to the right lookup tool:
+  - ISRC (e.g. USABC1234567) → directory_lookup_isrc → then directory_lookup_work_full
+  - ISWC (e.g. T-123.456.789-0) → directory_lookup_work_full
+  - IPI or ISNI → directory_lookup_person_full
+  - MusicBrainz ID → directory_lookup_person_full
+
+If I want to BROWSE what's in the directory:
+→ Use directory_search with a broad query, or directory_list_works / directory_list_people to paginate.
+
+Tell me which workflow you chose and why, in one sentence. Offer alternatives.
+
+Important: This is a read-only public directory. I can search and look up, but I can't create or modify anything. Only works from organisations that opted into the directory are visible.`,
+                    },
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAyBH,MAAM,OAAO,cAAc;IACzB,WAAW;QACT,OAAO;YACL;gBACE,IAAI,EAAE,YAAY;gBAClB,WAAW,EACT,sGAAsG;gBACxG,SAAS,EAAE;oBACT;wBACE,IAAI,EAAE,OAAO;wBACb,WAAW,EACT,+EAA+E;wBACjF,QAAQ,EAAE,KAAK;qBAChB;iBACF;aACF;YACD;gBACE,IAAI,EAAE,kBAAkB;gBACxB,WAAW,EACT,sHAAsH;gBACxH,SAAS,EAAE;oBACT;wBACE,IAAI,EAAE,YAAY;wBAClB,WAAW,EAAE,mDAAmD;wBAChE,QAAQ,EAAE,KAAK;qBAChB;iBACF;aACF;YACD;gBACE,IAAI,EAAE,qBAAqB;gBAC3B,WAAW,EACT,2IAA2I;gBAC7I,SAAS,EAAE,EAAE;aACd;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CACb,IAAY,EACZ,IAA0B;QAE1B,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,YAAY;gBACf,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC9C,KAAK,kBAAkB;gBACrB,OAAO,IAAI,CAAC,wBAAwB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACzD,KAAK,qBAAqB;gBACxB,OAAO,IAAI,CAAC,2BAA2B,EAAE,CAAC;YAC5C;gBACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAEO,kBAAkB,CAAC,KAAc;QACvC,MAAM,gBAAgB,GAAG,KAAK;YAC5B,CAAC,CAAC,6BAA6B,KAAK,iDAAiD;YACrF,CAAC,CAAC,8GAA8G,CAAC;QAEnH,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;EAEhB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;kIAyBgH;qBACvH;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAEO,wBAAwB,CAAC,QAAiB;QAChD,MAAM,iBAAiB,GAAG,QAAQ;YAChC,CAAC,CAAC,aAAa,QAAQ,iKAAiK;YACxL,CAAC,CAAC,qEAAqE,CAAC;QAE1E,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;EAEhB,iBAAiB;;;;;;;;;;;;;;;;;;;;0IAoBuH;qBAC/H;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAEO,2BAA2B;QACjC,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;2LAwByK;qBAChL;iBACF;aACF;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/resources/llms-primer.d.ts

@@ -0,0 +1,2 @@
+export declare const DIRECTORY_PRIMER = "# PICA Directory \u2014 Public Music Catalog Search\n\nRead-only access to published music catalog data. No authentication required.\nWorks and people are only visible if the owning organisation has opted into\nthe directory.\n\n## First Connection\n\nIf you're not sure where to start, invoke the **directory-autopilot** prompt.\nIt asks what you need and routes to the right workflow: sync search, rights\nresearch, or identifier lookup.\n\n## What You Can Do\n- Search works by title, ISWC, publisher, label\n- Search people by name, ISNI, IPI\n- Look up works by recording ISRC (directory_lookup_isrc)\n- Search recordings by audio characteristics (BPM, key, mood, energy)\n\n## What You Cannot Do\n- Create, update, or delete anything (read-only)\n- Access unpublished works or private catalog data\n- See financial data, agreements, or internal metadata\n\n## Entity Model\n- **Work**: composition with title, ISWC, credits, recordings\n- **Person**: writer/composer/performer with IPI, ISNI identifiers\n- **Recording**: audio capture with ISRC, linked to one work\n\n## Recommended Flow\n1. directory_search (broad text search across works + people)\n2. directory_lookup_work or directory_lookup_person (detailed view)\n3. directory_search_recordings (audio characteristic search for sync)\n";
+//# sourceMappingURL=llms-primer.d.ts.map

package/dist/resources/llms-primer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-primer.d.ts","sourceRoot":"","sources":["../../src/resources/llms-primer.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,wxCAgC5B,CAAC"}

package/dist/resources/llms-primer.js

@@ -0,0 +1,34 @@
+export const DIRECTORY_PRIMER = `# PICA Directory — Public Music Catalog Search
+
+Read-only access to published music catalog data. No authentication required.
+Works and people are only visible if the owning organisation has opted into
+the directory.
+
+## First Connection
+
+If you're not sure where to start, invoke the **directory-autopilot** prompt.
+It asks what you need and routes to the right workflow: sync search, rights
+research, or identifier lookup.
+
+## What You Can Do
+- Search works by title, ISWC, publisher, label
+- Search people by name, ISNI, IPI
+- Look up works by recording ISRC (directory_lookup_isrc)
+- Search recordings by audio characteristics (BPM, key, mood, energy)
+
+## What You Cannot Do
+- Create, update, or delete anything (read-only)
+- Access unpublished works or private catalog data
+- See financial data, agreements, or internal metadata
+
+## Entity Model
+- **Work**: composition with title, ISWC, credits, recordings
+- **Person**: writer/composer/performer with IPI, ISNI identifiers
+- **Recording**: audio capture with ISRC, linked to one work
+
+## Recommended Flow
+1. directory_search (broad text search across works + people)
+2. directory_lookup_work or directory_lookup_person (detailed view)
+3. directory_search_recordings (audio characteristic search for sync)
+`;
+//# sourceMappingURL=llms-primer.js.map

package/dist/resources/llms-primer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-primer.js","sourceRoot":"","sources":["../../src/resources/llms-primer.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC/B,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,13 @@
+import { ServerConfig } from "./config.js";
+export declare class DirectoryMcpServer {
+    private server;
+    private client;
+    private toolRegistry;
+    private promptRegistry;
+    private config;
+    constructor(config: ServerConfig);
+    private setupHandlers;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,YAAY;IA2BhC,OAAO,CAAC,aAAa;IAkEf,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAUtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAI5B"}

package/dist/server.js

@@ -0,0 +1,103 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { DirectoryClient } from "./client.js";
+import { ToolRegistry } from "./tools/index.js";
+import { PromptRegistry } from "./prompts/index.js";
+import { logError } from "./utils/errors.js";
+import { DIRECTORY_PRIMER } from "./resources/llms-primer.js";
+export class DirectoryMcpServer {
+    server;
+    client;
+    toolRegistry;
+    promptRegistry;
+    config;
+    constructor(config) {
+        this.config = config;
+        this.client = new DirectoryClient({
+            baseUrl: config.directoryUrl,
+            debug: config.debug,
+        });
+        this.server = new Server({
+            name: config.serverName,
+            version: config.version,
+        }, {
+            capabilities: {
+                tools: {},
+                resources: {},
+                prompts: {},
+            },
+        });
+        this.toolRegistry = new ToolRegistry(this.client);
+        this.promptRegistry = new PromptRegistry();
+        this.setupHandlers();
+    }
+    setupHandlers() {
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            if (this.config.debug) {
+                console.error("[Directory MCP] Listing tools");
+            }
+            return { tools: this.toolRegistry.listTools() };
+        });
+        this.server.setRequestHandler(ListResourcesRequestSchema, async () => {
+            return {
+                resources: [
+                    {
+                        uri: "llms://primer",
+                        name: "PICA Domain Primer",
+                        description: "Plain-language description of PICA's domain model, entity relationships, and recommended agent workflows. Read this first.",
+                        mimeType: "text/markdown",
+                    },
+                ],
+            };
+        });
+        this.server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+            const { uri } = request.params;
+            if (uri === "llms://primer") {
+                return {
+                    contents: [
+                        {
+                            uri: "llms://primer",
+                            mimeType: "text/markdown",
+                            text: DIRECTORY_PRIMER,
+                        },
+                    ],
+                };
+            }
+            throw new Error(`Resource not found: ${uri}`);
+        });
+        this.server.setRequestHandler(ListPromptsRequestSchema, async () => {
+            return { prompts: this.promptRegistry.listPrompts() };
+        });
+        this.server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            return await this.promptRegistry.getPrompt(name, args);
+        });
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            if (this.config.debug) {
+                console.error(`[Directory MCP] Executing tool: ${name}`, args);
+            }
+            try {
+                return await this.toolRegistry.executeTool(name, args || {});
+            }
+            catch (error) {
+                logError(`Tool execution: ${name}`, error);
+                throw error;
+            }
+        });
+    }
+    async start() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error("[Directory MCP] PICA Directory MCP Server started");
+        console.error(`[Directory MCP] Version: ${this.config.version}`);
+        console.error(`[Directory MCP] API URL: ${this.config.directoryUrl}`);
+        console.error("[Directory MCP] Ready to accept connections");
+    }
+    async stop() {
+        await this.server.close();
+        console.error("[Directory MCP] Server stopped");
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts

@@ -0,0 +1,26 @@
+import { DirectoryClient } from "../client.js";
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: Record<string, any>;
+        required?: string[];
+    };
+}
+export interface ToolResult {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    structuredContent?: Record<string, unknown>;
+    isError?: boolean;
+}
+export type ToolExecutor = (args: Record<string, any>) => Promise<any>;
+export declare class ToolRegistry {
+    private tools;
+    constructor(client: DirectoryClient);
+    listTools(): ToolDefinition[];
+    executeTool(name: string, args: Record<string, any>): Promise<any>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAO/C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAEvE,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAGX;gBAEU,MAAM,EAAE,eAAe;IAiBnC,SAAS,IAAI,cAAc,EAAE;IAIvB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;CAgBzE"}