@jspm/local-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JSPM
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/Readme.md

@@ -0,0 +1,140 @@
+# `@jspm/local-mcp`
+
+`@jspm/local-mcp` is a local-first [Model Context Protocol](https://modelcontextprotocol.io/) server for managing JSPM import maps inside a real project directory.
+
+It is built for coding agents that already have filesystem access to your repo, such as Codex, Claude Code / Claude Desktop, Cursor, and VS Code MCP clients.
+
+Instead of asking an LLM to hand-edit only the `imports` section and accidentally break `scopes`, this server uses `@jspm/generator` to keep the full import map correct.
+
+## Why local-first
+
+- It works directly against your project files.
+- It can write either `importmap.json` or inject an inline import map into an HTML file.
+- It can trace local source files and install the dependencies they actually use.
+- It preserves and reloads an existing import map when you revisit a project.
+
+## Tools
+
+The server exposes these MCP tools:
+
+- `set_project`: set the working project directory.
+- `set_target`: choose `importmap` or `html` output mode.
+- `install_package`: install one or more packages with JSPM.
+- `uninstall_package`: remove one or more packages from the import map.
+- `trace_file`: trace imports from local source files and add the required mappings.
+
+## Install
+
+After publish, the simplest way to run it will be with `npx`:
+
+```sh
+npx -y @jspm/local-mcp
+```
+
+You can also install it globally:
+
+```sh
+npm install -g @jspm/local-mcp
+jspm-local-mcp
+```
+
+## MCP Client Setup
+
+### Codex
+
+Add an MCP server that runs `npx`:
+
+```json
+{
+  "mcpServers": {
+    "jspm": {
+      "command": "npx",
+      "args": ["-y", "@jspm/local-mcp"]
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "jspm": {
+      "command": "npx",
+      "args": ["-y", "@jspm/local-mcp"]
+    }
+  }
+}
+```
+
+### VS Code MCP / GitHub Copilot
+
+```json
+{
+  "servers": {
+    "jspm": {
+      "command": "npx",
+      "args": ["-y", "@jspm/local-mcp"]
+    }
+  }
+}
+```
+
+If your environment does not expose `npx`, point the client at the installed executable instead.
+
+## Typical Flow
+
+Example conversation:
+
+```text
+Set the project to the current workspace.
+Use index.html as the import map target.
+Install react and react-dom.
+Trace src/main.js and update the import map.
+```
+
+Equivalent tool calls:
+
+1. `set_project({ path: "/absolute/path/to/project" })`
+2. `set_target({ target: "html", fileName: "index.html" })`
+3. `install_package({ packages: [{ packageName: "react" }, { packageName: "react-dom" }] })`
+4. `trace_file({ fileNames: ["src/main.js"] })`
+
+## Behavior Notes
+
+- `set_project` defaults to `importmap.json`.
+- Switching targets reloads the generator from the current file state.
+- `set_target("html")` reads the existing HTML file and preserves any inline import map already there.
+- `trace_file` works on files inside the configured project directory.
+- Target files are restricted to the configured project directory.
+
+## Local Development
+
+```sh
+npm install
+npm run build
+npm start
+```
+
+For local unpublished testing, point your MCP client to:
+
+```json
+{
+  "command": "node",
+  "args": ["/absolute/path/to/jspm-mcp/dist/index.js"]
+}
+```
+
+## Publish Checklist
+
+```sh
+npm run build
+npm publish --access public
+```
+
+`prepublishOnly` rebuilds `dist` before publish.
+
+## License
+
+MIT

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,294 @@
+#!/usr/bin/env node
+import { Generator } from "@jspm/generator";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { existsSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import process from "node:process";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { z } from "zod";
+import { ensureProjectDirectory, ensureWritable, getImportMapLocation, getProjectFileLocation, normalizeMapTarget, } from "./utils.js";
+const server = new McpServer({
+    name: "@jspm/local-mcp",
+    version: "0.1.0",
+});
+const mapTargetSchema = z.enum(["importmap", "html"]);
+const state = {
+    mapTarget: "importmap",
+};
+function failure(text) {
+    return {
+        content: [{ type: "text", text }],
+        isError: true,
+    };
+}
+function trailingSlash(path) {
+    return path.endsWith("/") ? path : `${path}/`;
+}
+function ensureStateProjectPath() {
+    return ensureProjectDirectory(state.projectPath);
+}
+function assertInsideProject(projectPath, candidatePath) {
+    const normalizedProjectPath = trailingSlash(resolve(projectPath));
+    const normalizedCandidatePath = resolve(candidatePath);
+    if (normalizedCandidatePath !== resolve(projectPath) &&
+        !normalizedCandidatePath.startsWith(normalizedProjectPath)) {
+        throw new Error("Target file must stay inside the configured project");
+    }
+    return normalizedCandidatePath;
+}
+function resolveProjectFilePath(fileName) {
+    const projectPath = ensureStateProjectPath();
+    const filePath = getProjectFileLocation(projectPath, fileName);
+    return assertInsideProject(projectPath, filePath);
+}
+function getGenerator() {
+    if (!state.generator) {
+        throw new Error("Generator is not ready. Call set_project first and optionally set_target.");
+    }
+    return state.generator;
+}
+async function refreshGenerator() {
+    const projectPath = ensureStateProjectPath();
+    const projectUrl = pathToFileURL(trailingSlash(projectPath));
+    const mapPath = state.mapTarget === "html"
+        ? resolveProjectFilePath(state.htmlFileName)
+        : getImportMapLocation(projectPath);
+    const mapUrl = pathToFileURL(mapPath);
+    const generator = new Generator({
+        mapUrl,
+        rootUrl: projectUrl,
+        defaultProvider: "jspm",
+    });
+    if (state.mapTarget === "importmap") {
+        if (existsSync(mapPath)) {
+            await generator.addMappings(readFileSync(mapPath, "utf-8"), mapUrl, projectUrl);
+        }
+    }
+    else {
+        const htmlSource = readFileSync(mapPath, "utf-8");
+        await generator.addMappings(htmlSource, mapUrl, projectUrl);
+    }
+    state.generator = generator;
+}
+async function saveImportMap() {
+    const projectPath = ensureStateProjectPath();
+    const generator = getGenerator();
+    const projectUrl = pathToFileURL(trailingSlash(projectPath));
+    try {
+        if (state.mapTarget === "importmap") {
+            const importMapPath = getImportMapLocation(projectPath);
+            const parentDirectory = dirname(importMapPath);
+            await ensureWritable(parentDirectory);
+            writeFileSync(importMapPath, `${JSON.stringify(generator.getMap(), null, 2)}\n`, "utf-8");
+            return;
+        }
+        const htmlPath = resolveProjectFilePath(state.htmlFileName);
+        const htmlSource = readFileSync(htmlPath, "utf-8");
+        await ensureWritable(htmlPath);
+        const injectedHtml = await generator.htmlInject(htmlSource, {
+            trace: true,
+            htmlUrl: pathToFileURL(htmlPath),
+            rootUrl: projectUrl,
+            esModuleShims: true,
+        });
+        writeFileSync(htmlPath, injectedHtml, "utf-8");
+    }
+    catch (error) {
+        if (error.code === "EACCES") {
+            throw new Error("Permission denied while updating the import map target");
+        }
+        throw error;
+    }
+}
+server.registerTool("set_project", {
+    title: "Set current project",
+    description: "Sets the active project directory",
+    inputSchema: z.object({
+        path: z.string(),
+    }),
+}, async ({ path }) => {
+    try {
+        const projectPath = ensureProjectDirectory(resolve(path));
+        state.projectPath = projectPath;
+        state.mapTarget = "importmap";
+        state.htmlFileName = undefined;
+        await refreshGenerator();
+        const importMapPath = getImportMapLocation(projectPath);
+        const existingMapMessage = existsSync(importMapPath)
+            ? "Loaded the existing importmap.json from this project."
+            : "No importmap.json found yet. I will create one when you install packages.";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        `Project set to ${projectPath}.`,
+                        existingMapMessage,
+                        'The default target is "importmap". Call set_target with "html" and a fileName to manage an HTML file instead.',
+                    ].join("\n"),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return failure(error.message);
+    }
+});
+server.registerTool("set_target", {
+    title: "Set how importmap is managed",
+    description: "Choose whether to store the importmap in a file or inject it into an HTML file.",
+    inputSchema: z.object({
+        target: z
+            .string()
+            .describe('Target type. Accepts flexible values like "importmap", "file", "json", "html", "inline".'),
+        fileName: z
+            .string()
+            .optional()
+            .describe("Required when using HTML target (e.g. index.html)"),
+    }),
+}, async ({ target, fileName }) => {
+    try {
+        ensureStateProjectPath();
+        const normalizedTarget = normalizeMapTarget(target);
+        if (normalizedTarget === "html") {
+            if (!fileName) {
+                return failure('HTML target requires "fileName" (for example "index.html")');
+            }
+            const htmlPath = resolveProjectFilePath(fileName);
+            if (!existsSync(htmlPath)) {
+                return failure(`HTML file not found: ${fileName}`);
+            }
+            if (!statSync(htmlPath).isFile()) {
+                return failure(`Target is not a file: ${fileName}`);
+            }
+            state.mapTarget = "html";
+            state.htmlFileName = fileName;
+            await refreshGenerator();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Importmap target set to HTML: ${fileName}`,
+                    },
+                ],
+            };
+        }
+        state.mapTarget = "importmap";
+        state.htmlFileName = undefined;
+        await refreshGenerator();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Importmap target set to importmap.json",
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return failure(error.message);
+    }
+});
+server.registerTool("install_package", {
+    title: "Install a package / dependency",
+    description: "Installs one or more packages with @jspm/generator and updates the configured importmap target.",
+    inputSchema: z.object({
+        packages: z.array(z.object({
+            packageName: z.string(),
+            version: z.string().optional(),
+        })),
+    }),
+}, async ({ packages }) => {
+    try {
+        const generator = getGenerator();
+        const content = [];
+        for (const input of packages) {
+            const specifier = input.version
+                ? `${input.packageName}@${input.version}`
+                : input.packageName;
+            await generator.install(specifier);
+            content.push({ type: "text", text: `Installed ${specifier}` });
+        }
+        await saveImportMap();
+        return { content };
+    }
+    catch (error) {
+        return failure(error.message);
+    }
+});
+server.registerTool("uninstall_package", {
+    title: "Uninstall a package / dependency",
+    description: "Removes one or more packages from the importmap and saves the result.",
+    inputSchema: z.object({
+        packageName: z.union([z.string(), z.array(z.string())]),
+    }),
+}, async ({ packageName }) => {
+    try {
+        const generator = getGenerator();
+        const packages = Array.isArray(packageName) ? packageName : [packageName];
+        await generator.uninstall(packages);
+        await saveImportMap();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Uninstalled ${packages.join(", ")}`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return failure(error.message);
+    }
+});
+server.registerTool("trace_file", {
+    title: "Trace file imports",
+    description: "Traces imports from one or more local source files and adds the required mappings to the importmap.",
+    inputSchema: z.object({
+        fileNames: z.array(z.string()),
+    }),
+}, async ({ fileNames }) => {
+    try {
+        const generator = getGenerator();
+        const content = [];
+        for (const fileName of fileNames) {
+            const filePath = resolveProjectFilePath(fileName);
+            if (!existsSync(filePath)) {
+                return failure(`File not found: ${fileName}`);
+            }
+            await generator.link(pathToFileURL(filePath).href);
+            content.push({
+                type: "text",
+                text: `Scanned imports from ${fileName}`,
+            });
+        }
+        await saveImportMap();
+        return {
+            content: [
+                ...content,
+                {
+                    type: "text",
+                    text: "Updated the importmap target with traced dependencies.",
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return failure(error.message);
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    await server.sendLoggingMessage({
+        level: "info",
+        data: "JSPM MCP server started",
+    });
+    console.error(`JSPM MCP server running from ${fileURLToPath(import.meta.url)}`);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,6 @@
+export declare function ensureWritable(path: string): Promise<void>;
+export declare function ensureProjectDirectory(projectPath?: string): string;
+export declare function normalizeMapTarget(input: string): "importmap" | "html";
+export declare function getImportMapLocation(projectPath?: string): string;
+export declare function getProjectFileLocation(projectPath: string | undefined, fileName: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAIA,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,iBAMhD;AAED,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBnE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CActE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,QAAQ,EAAE,MAAM,GACf,MAAM,CAMR"}

package/dist/utils.js

@@ -0,0 +1,44 @@
+import { access } from "node:fs/promises";
+import { constants, existsSync, statSync } from "node:fs";
+import { resolve } from "node:path";
+export async function ensureWritable(path) {
+    try {
+        await access(path, constants.W_OK);
+    }
+    catch {
+        throw new Error(`No write permission for: ${path}`);
+    }
+}
+export function ensureProjectDirectory(projectPath) {
+    if (!projectPath) {
+        throw new Error("Project path is not configured");
+    }
+    const resolvedPath = resolve(projectPath);
+    if (!existsSync(resolvedPath)) {
+        throw new Error(`Project path does not exist: ${resolvedPath}`);
+    }
+    if (!statSync(resolvedPath).isDirectory()) {
+        throw new Error(`Project path is not a directory: ${resolvedPath}`);
+    }
+    return resolvedPath;
+}
+export function normalizeMapTarget(input) {
+    const value = input.toLowerCase().trim();
+    if (["html", "inline", "dom", "page"].includes(value)) {
+        return "html";
+    }
+    if (["importmap", "file", "json", "map"].includes(value)) {
+        return "importmap";
+    }
+    throw new Error(`Invalid target "${input}". Use something like "importmap" or "html".`);
+}
+export function getImportMapLocation(projectPath) {
+    return resolve(ensureProjectDirectory(projectPath), "importmap.json");
+}
+export function getProjectFileLocation(projectPath, fileName) {
+    if (!fileName) {
+        throw new Error("HTML file name is not configured");
+    }
+    return resolve(ensureProjectDirectory(projectPath), fileName);
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,WAAoB;IACzD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE1C,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,gCAAgC,YAAY,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,oCAAoC,YAAY,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAEzC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,mBAAmB,KAAK,8CAA8C,CACvE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,WAAoB;IACvD,OAAO,OAAO,CAAC,sBAAsB,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,WAA+B,EAC/B,QAAgB;IAEhB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,OAAO,CAAC,sBAAsB,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;AAChE,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@jspm/local-mcp",
+  "mcpName": "io.github.jspm/local-mcp",
+  "version": "0.1.0",
+  "description": "A local-first MCP server for managing JSPM import maps in real projects.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "jspm-local-mcp": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "Readme.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "start": "node dist/index.js",
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "author": "JSPM",
+  "license": "MIT",
+  "homepage": "https://github.com/jspm/mcp#readme",
+  "bugs": {
+    "url": "https://github.com/jspm/mcp/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jspm/mcp.git"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "jspm",
+    "importmap",
+    "import-maps",
+    "esm"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.19.17",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  },
+  "dependencies": {
+    "@jspm/generator": "^2.13.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.25.76"
+  }
+}