@lingochunk/mcp 0.3.0 → 0.8.0

package/dist/http.js

@@ -0,0 +1,174 @@
+import { createServer, } from "node:http";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { LingoChunkClient } from "./client.js";
+import { registerTools } from "./tools.js";
+import { registerPrompts } from "./prompts.js";
+// Remote MCP clients (claude.ai, ChatGPT, Le Chat, ...) call server-to-server,
+// but browser-based clients (the MCP inspector, web IDEs) preflight with CORS.
+// The wildcard origin is safe: authentication is a per-request Bearer token,
+// never a cookie, so no ambient credentials can be replayed cross-origin.
+const CORS_HEADERS = {
+    "Access-Control-Allow-Origin": "*",
+    "Access-Control-Allow-Methods": "GET, POST, DELETE, OPTIONS",
+    "Access-Control-Allow-Headers": "Content-Type, Authorization, Mcp-Session-Id, Mcp-Protocol-Version, Last-Event-ID",
+    "Access-Control-Expose-Headers": "Mcp-Session-Id, Mcp-Protocol-Version",
+};
+function applyCors(res) {
+    for (const [name, value] of Object.entries(CORS_HEADERS)) {
+        res.setHeader(name, value);
+    }
+}
+function sendJson(res, status, body, headers = {}) {
+    res.writeHead(status, { "Content-Type": "application/json", ...headers });
+    res.end(JSON.stringify(body));
+}
+/** Extract the Bearer credential, or null when absent/malformed. */
+function bearerToken(req) {
+    const header = req.headers.authorization;
+    if (!header)
+        return null;
+    const match = /^Bearer\s+(.+)$/i.exec(header);
+    const token = match?.[1]?.trim();
+    return token ? token : null;
+}
+function unauthorized(res, publicOrigin) {
+    // JSON-RPC error shape so MCP clients surface the message; -32001 is the
+    // de-facto "auth required" code used across MCP servers. resource_metadata
+    // (RFC 9728) is what OAuth-capable clients (claude.ai, ChatGPT, Gemini)
+    // follow to discover the sign-in flow served by the main app.
+    sendJson(res, 401, {
+        jsonrpc: "2.0",
+        error: {
+            code: -32001,
+            message: "Authentication required. Sign in via OAuth (your client offers " +
+                "this automatically), or create a personal access token in your " +
+                "LingoChunk account settings (Settings -> API tokens, it starts " +
+                "with 'lcp_') and send it as 'Authorization: Bearer <token>'. " +
+                "For clients without a token field, put it in the URL instead: " +
+                "/mcp/t/<token>.",
+        },
+        id: null,
+    }, {
+        "WWW-Authenticate": 'Bearer realm="LingoChunk", error="invalid_token", ' +
+            `resource_metadata="${publicOrigin}/.well-known/oauth-protected-resource/mcp"`,
+    });
+}
+/**
+ * Serve the MCP server over Streamable HTTP for remote clients.
+ *
+ * Stateless by design: every POST builds a fresh McpServer + transport bound
+ * to the caller's own Bearer token, so one process serves many users with no
+ * session affinity and no token ever outliving its request. The token is not
+ * validated here - it is forwarded verbatim and the LingoChunk API stays the
+ * single authority (a bad token fails at the first tool call with the API's
+ * own 401 message).
+ *
+ * Endpoints: POST /mcp (the MCP wire), GET /health (liveness). GET/DELETE
+ * /mcp return 405: stateless mode has no server-push stream and no session
+ * to delete.
+ */
+export function startHttpServer(options) {
+    const httpServer = createServer((req, res) => {
+        void handle(req, res, options).catch((err) => {
+            const message = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`lingochunk-mcp http error: ${message}\n`);
+            if (!res.headersSent) {
+                sendJson(res, 500, {
+                    jsonrpc: "2.0",
+                    error: { code: -32603, message: "Internal server error." },
+                    id: null,
+                });
+            }
+            else {
+                res.end();
+            }
+        });
+    });
+    return new Promise((resolve, reject) => {
+        httpServer.once("error", reject);
+        httpServer.listen(options.port, () => {
+            httpServer.removeListener("error", reject);
+            resolve(httpServer);
+        });
+    });
+}
+async function handle(req, res, options) {
+    applyCors(res);
+    // Serve the MCP wire on both /mcp and / : deployed behind a path-stripping
+    // proxy (kamal-proxy --path-prefix /mcp strips by default), requests to
+    // https://host/mcp arrive here as "/"; run directly (docker -p), they
+    // arrive as "/mcp". Health likewise answers /health and /mcp/health.
+    const rawPath = new URL(req.url ?? "/", "http://localhost").pathname;
+    let path = rawPath === "/mcp" || rawPath === "/"
+        ? "/"
+        : rawPath.startsWith("/mcp/")
+            ? rawPath.slice("/mcp".length)
+            : rawPath;
+    // Tokened-URL auth: /t/<token> is the MCP wire with the credential in the
+    // path, for clients whose connector UI has no header/token field and no
+    // OAuth-less fallback (claude.ai custom connectors). The URL is then a
+    // secret - it lands in proxy/access logs - which is acceptable as a
+    // documented stopgap because PATs are scoped and one-click revocable.
+    // An Authorization header, when present, still wins below.
+    let pathToken = null;
+    const tokened = /^\/t\/([^/]+)$/.exec(path);
+    if (tokened?.[1]) {
+        pathToken = decodeURIComponent(tokened[1]).trim() || null;
+        path = "/";
+    }
+    if (req.method === "OPTIONS") {
+        res.writeHead(204).end();
+        return;
+    }
+    if (path === "/health" && req.method === "GET") {
+        sendJson(res, 200, {
+            status: "ok",
+            name: "lingochunk-mcp",
+            version: options.version,
+            transport: "streamable-http",
+        });
+        return;
+    }
+    if (path !== "/") {
+        sendJson(res, 404, { detail: "Not found. The MCP endpoint is POST /mcp." });
+        return;
+    }
+    if (req.method !== "POST") {
+        sendJson(res, 405, {
+            jsonrpc: "2.0",
+            error: {
+                code: -32000,
+                message: "Method not allowed. This server is stateless: POST /mcp only.",
+            },
+            id: null,
+        }, { Allow: "POST" });
+        return;
+    }
+    const token = bearerToken(req) ?? pathToken;
+    if (!token) {
+        unauthorized(res, options.publicOrigin);
+        return;
+    }
+    // Fresh server per request: tools close over THIS caller's client. clipDir
+    // is never used because remote mode does not register get_audio_clip.
+    const client = new LingoChunkClient({
+        baseUrl: options.baseUrl,
+        token,
+        clipDir: "",
+    });
+    const server = new McpServer({ name: "lingochunk", version: options.version });
+    registerTools(server, client, { baseUrl: options.baseUrl, token, clipDir: "" }, "remote");
+    registerPrompts(server);
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: undefined,
+        enableJsonResponse: true,
+    });
+    res.on("close", () => {
+        void transport.close();
+        void server.close();
+    });
+    await server.connect(transport);
+    await transport.handleRequest(req, res);
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.js

@@ -1,17 +1,40 @@
 #!/usr/bin/env node
+import { readFileSync } from "node:fs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { loadConfig } from "./config.js";
+import { loadConfig, loadHttpConfig } from "./config.js";
 import { LingoChunkClient } from "./client.js";
+import { startHttpServer } from "./http.js";
 import { registerTools } from "./tools.js";
-const VERSION = "0.2.1";
+import { registerPrompts } from "./prompts.js";
+// Single source of truth for the version: the package manifest. A hardcoded
+// copy here once drifted (the server reported 0.2.1 while npm shipped 0.3.0),
+// which made "is my server up to date?" unanswerable.
+const VERSION = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
+// `npx -y @lingochunk/mcp --version` prints the running version and exits,
+// so users can compare against `npm view @lingochunk/mcp version` (README
+// "Updating" section). Checked before any config loading: no token needed.
+if (process.argv.includes("--version") || process.argv.includes("-v")) {
+    process.stdout.write(`${VERSION}\n`);
+    process.exit(0);
+}
 async function main() {
+    // --http runs the hosted multi-user server (Streamable HTTP, per-request
+    // Bearer tokens) instead of the single-user stdio process.
+    if (process.argv.includes("--http")) {
+        const httpConfig = loadHttpConfig();
+        await startHttpServer({ ...httpConfig, version: VERSION });
+        process.stderr.write(`lingochunk-mcp ${VERSION} listening on :${httpConfig.port} ` +
+            `(POST /mcp), API ${httpConfig.baseUrl}\n`);
+        return;
+    }
     // Fail fast (to stderr, never stdout - stdout is the MCP wire) if the token
     // is missing, so onboarding surfaces the problem immediately.
     const config = loadConfig();
     const client = new LingoChunkClient(config);
     const server = new McpServer({ name: "lingochunk", version: VERSION });
     registerTools(server, client, config);
+    registerPrompts(server);
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,KAAK,UAAU,IAAI;IACjB,4EAA4E;IAC5E,8DAA8D;IAC9D,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAE5C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACvE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,OAAO,IAAI,CAAC,CAAC;IACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,4EAA4E;AAC5E,8EAA8E;AAC9E,sDAAsD;AACtD,MAAM,OAAO,GACX,IAAI,CAAC,KAAK,CACR,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAEpE,CAAC,OAAO,CAAC;AAEV,2EAA2E;AAC3E,0EAA0E;AAC1E,2EAA2E;AAC3E,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACtE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,yEAAyE;IACzE,2DAA2D;IAC3D,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;QACpC,MAAM,eAAe,CAAC,EAAE,GAAG,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,kBAAkB,OAAO,kBAAkB,UAAU,CAAC,IAAI,GAAG;YAC3D,oBAAoB,UAAU,CAAC,OAAO,IAAI,CAC7C,CAAC;QACF,OAAO;IACT,CAAC;IAED,4EAA4E;IAC5E,8DAA8D;IAC9D,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAE5C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACvE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,OAAO,IAAI,CAAC,CAAC;IACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register one MCP prompt per authoring skill (name `lingochunk-<skill>`),
+ * each returning that skill's full markdown as a user-role message. This is
+ * how remote clients (claude.ai, ChatGPT, ...) can pull the craft guidance a
+ * slash-command / prompt picker exposes - the same content get_authoring_guide
+ * serves as a tool, but surfaced through the prompts capability.
+ *
+ * Calling registerPrompt makes the high-level McpServer advertise the prompts
+ * capability in the initialize handshake, so this must run before
+ * server.connect() in BOTH transports (stdio in index.ts, HTTP in http.ts).
+ */
+export declare function registerPrompts(server: McpServer): void;

package/dist/prompts.js

@@ -0,0 +1,26 @@
+import { GUIDES, GUIDE_TOPICS } from "./generated/guides.js";
+/**
+ * Register one MCP prompt per authoring skill (name `lingochunk-<skill>`),
+ * each returning that skill's full markdown as a user-role message. This is
+ * how remote clients (claude.ai, ChatGPT, ...) can pull the craft guidance a
+ * slash-command / prompt picker exposes - the same content get_authoring_guide
+ * serves as a tool, but surfaced through the prompts capability.
+ *
+ * Calling registerPrompt makes the high-level McpServer advertise the prompts
+ * capability in the initialize handshake, so this must run before
+ * server.connect() in BOTH transports (stdio in index.ts, HTTP in http.ts).
+ */
+export function registerPrompts(server) {
+    for (const topic of GUIDE_TOPICS) {
+        const guide = GUIDES[topic];
+        server.registerPrompt(guide.promptName, { title: guide.promptName, description: guide.description }, () => ({
+            messages: [
+                {
+                    role: "user",
+                    content: { type: "text", text: guide.body },
+                },
+            ],
+        }));
+    }
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,CAAC,cAAc,CACnB,KAAK,CAAC,UAAU,EAChB,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,EAC3D,GAAG,EAAE,CAAC,CAAC;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;iBAC5C;aACF;SACF,CAAC,CACH,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools.d.ts

@@ -1,4 +1,10 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { type LingoChunkClient } from "./client.js";
 import type { Config } from "./config.js";
-export declare function registerTools(server: McpServer, client: LingoChunkClient, config: Config): void;
+/** Where the server runs relative to the user. "local": a stdio process on
+ *  the user's machine (files it writes are the user's files). "remote": a
+ *  hosted multi-user HTTP server, where writing to the local filesystem is
+ *  meaningless to the caller - so get_audio_clip is not offered and sibling
+ *  descriptions stop pointing at it. */
+export type ToolMode = "local" | "remote";
+export declare function registerTools(server: McpServer, client: LingoChunkClient, config: Config, mode?: ToolMode): void;