scc-mcp 0.1.0 → 0.2.0

package/dist/dispatch.js

@@ -1,3 +1,82 @@
+// Turns a tool call into an HTTP request, driven entirely by the `exec` spec
+// the server sent in the manifest. The package contains no endpoint knowledge
+// of its own — this is a generic manifest→REST bridge.
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, extname } from "node:path";
+// Extension → MIME for local-file uploads. Mirrors the API's ALLOWED_MIME so the
+// inferred type is one the upload endpoint accepts; unknown extensions fall back
+// to an explicit `mime` arg (and the server rejects anything it can't handle).
+const EXT_MIME = {
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".png": "image/png",
+    ".webp": "image/webp",
+    ".gif": "image/gif",
+    ".svg": "image/svg+xml",
+    ".pdf": "application/pdf",
+    ".doc": "application/msword",
+    ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    ".xls": "application/vnd.ms-excel",
+    ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    ".ppt": "application/vnd.ms-powerpoint",
+    ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    ".txt": "text/plain",
+    ".mp3": "audio/mpeg",
+    ".wav": "audio/wav",
+    ".ogg": "audio/ogg",
+    ".m4a": "audio/mp4",
+    ".aac": "audio/aac",
+};
+/** Expand a leading ~ to the user's home directory. */
+function expandHome(p) {
+    if (p === "~")
+        return homedir();
+    if (p.startsWith("~/") || p.startsWith("~\\"))
+        return homedir() + p.slice(1);
+    return p;
+}
+/**
+ * For a readFile exec: read the file at args[pathArg] off the local disk,
+ * base64-encode it, and return a new args object with { data, filename, mime }
+ * filled in (and the path arg removed). Throws a clear Error the caller turns
+ * into a tool-call error if the file can't be read or its type can't be inferred.
+ */
+function applyReadFile(exec, args) {
+    const spec = exec.readFile;
+    if (!spec)
+        return args;
+    const { pathArg, dataArg = "data", filenameArg = "filename", mimeArg = "mime" } = spec;
+    const raw = args[pathArg];
+    if (typeof raw !== "string" || !raw.trim()) {
+        throw new Error(`A file path (${pathArg}) is required.`);
+    }
+    const filePath = expandHome(raw.trim());
+    let bytes;
+    try {
+        bytes = readFileSync(filePath);
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        throw new Error(`Could not read the file at ${filePath} — ${reason}`);
+    }
+    if (bytes.byteLength === 0)
+        throw new Error(`The file at ${filePath} is empty.`);
+    const out = { ...args };
+    delete out[pathArg];
+    out[dataArg] = bytes.toString("base64");
+    if (out[filenameArg] === undefined || out[filenameArg] === "") {
+        out[filenameArg] = basename(filePath);
+    }
+    if (out[mimeArg] === undefined || out[mimeArg] === "") {
+        const mime = EXT_MIME[extname(filePath).toLowerCase()];
+        if (!mime) {
+            throw new Error(`Could not determine the file type of ${basename(filePath)} from its extension; pass an explicit "${mimeArg}".`);
+        }
+        out[mimeArg] = mime;
+    }
+    return out;
+}
 /** Resolve {placeholders} in the path and return the args not consumed by it. */
 function fillPath(template, args) {
     const used = new Set();
@@ -55,7 +134,25 @@ function buildRequest(exec, args) {
     return req;
 }
 export async function execute(client, exec, args) {
-    const { method, path, query, body } = buildRequest(exec, args);
+    let effectiveArgs = args;
+    if (exec.readFile) {
+        try {
+            // Read + base64 the local file HERE (in the MCP), so the bytes go straight
+            // to the API and never pass through the model's context.
+            effectiveArgs = applyReadFile(exec, args);
+        }
+        catch (err) {
+            // Surface a read/inference failure as a normal failed result so toContent
+            // renders it as a tool error instead of crashing the request handler.
+            return {
+                ok: false,
+                status: 0,
+                text: err instanceof Error ? err.message : String(err),
+                contentType: "text/plain",
+            };
+        }
+    }
+    const { method, path, query, body } = buildRequest(exec, effectiveArgs);
     return client.request(method, path, { query, body });
 }
 /** Format an API result as MCP tool-call content. */

package/dist/index.js

@@ -15,7 +15,7 @@ if (process.argv[2] === "install") {
     });
     process.exit(0);
 }
-const VERSION = "0.1.0";
+const VERSION = "0.2.0";
 const API_URL = process.env.SCC_API_URL ?? "http://localhost:3200";
 const API_KEY = process.env.SCC_API_KEY ?? "";
 if (!API_KEY) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "scc-mcp",
-	"version": "0.1.0",
+	"version": "0.2.0",
 	"type": "module",
 	"description": "Key-based MCP server exposing the Scarborough Community Choir API so an AI can query data and act like an assistant.",
 	"repository": {
@@ -21,7 +21,8 @@
 		"start": "node dist/index.js",
 		"install:claude": "node dist/index.js install",
 		"build": "tsc",
-		"typecheck": "tsc --noEmit"
+		"typecheck": "tsc --noEmit",
+		"prepublishOnly": "npm run build"
 	},
 	"dependencies": {
 		"@modelcontextprotocol/sdk": "^1.29.0",