@mario.andreschak/mcp-filesystem 3.39.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export * from './tools.js';
+export * from './resources.js';

package/dist/index.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListResourceTemplatesRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { configureRootsProvider } from './shared.js';
+import { filesystemCallTool, filesystemToolDefinitions } from './tools.js';
+import { filesystemListResources, filesystemReadResource, isFilesystemAppUri, isTouchedFileUri, readTouchedFileResource, } from './resources.js';
+export * from './tools.js';
+export * from './resources.js';
+const server = new Server({ name: '@mario.andreschak/mcp-filesystem', version: '0.1.0' }, { capabilities: { tools: {}, resources: {} } });
+configureRootsProvider(async () => (await server.listRoots()).roots);
+function callerNodeIdOf(meta) {
+    if (!meta || typeof meta !== 'object')
+        return undefined;
+    const flujo = meta.flujo;
+    if (!flujo || typeof flujo !== 'object')
+        return undefined;
+    const callerNodeId = flujo.callerNodeId;
+    return typeof callerNodeId === 'string' && callerNodeId.length > 0
+        ? callerNodeId
+        : undefined;
+}
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: filesystemToolDefinitions(),
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => filesystemCallTool(request.params.name, request.params.arguments ?? {}, callerNodeIdOf(request.params._meta)));
+server.setRequestHandler(ListResourcesRequestSchema, async () => filesystemListResources());
+server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => ({ resourceTemplates: [] }));
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const uri = request.params.uri;
+    const result = isFilesystemAppUri(uri)
+        ? filesystemReadResource(uri)
+        : isTouchedFileUri(uri)
+            ? await readTouchedFileResource(uri)
+            : { success: false, error: `Unknown filesystem resource: ${uri}`, statusCode: 404 };
+    if (!result.success || !result.data)
+        throw new Error(result.error ?? `Could not read ${uri}`);
+    return result.data;
+});
+const transport = new StdioServerTransport();
+let closing = false;
+async function shutdown() {
+    if (closing)
+        return;
+    closing = true;
+    configureRootsProvider(undefined);
+    await server.close().catch(() => undefined);
+}
+process.once('SIGINT', () => void shutdown());
+process.once('SIGTERM', () => void shutdown());
+process.once('SIGHUP', () => void shutdown());
+server.connect(transport).catch((error) => {
+    process.stderr.write(`@mario.andreschak/mcp-filesystem failed: ${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
+    process.exitCode = 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":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,kCAAkC,EAClC,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAE/B,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,kCAAkC,EAAE,OAAO,EAAE,OAAO,EAAE,EAC9D,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,CAC/C,CAAC;AAEF,sBAAsB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;AAErE,SAAS,cAAc,CAAC,IAAa;IACnC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACxD,MAAM,KAAK,GAAI,IAAgC,CAAC,KAAK,CAAC;IACtD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC1D,MAAM,YAAY,GAAI,KAAiC,CAAC,YAAY,CAAC;IACrE,OAAO,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;QAChE,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK,EAAE,yBAAyB,EAAE;CACnC,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAChE,kBAAkB,CAChB,OAAO,CAAC,MAAM,CAAC,IAAI,EACnB,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,EAC9B,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CACrC,CACF,CAAC;AAEF,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE,CAAC,uBAAuB,EAAE,CAAC,CAAC;AAC5F,MAAM,CAAC,iBAAiB,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;AACtG,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IACpE,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;IAC/B,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC;QACpC,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC;QAC7B,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC;YACrB,CAAC,CAAC,MAAM,uBAAuB,CAAC,GAAG,CAAC;YACpC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,gCAAgC,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;IACxF,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,kBAAkB,GAAG,EAAE,CAAC,CAAC;IAC9F,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,IAAI,OAAO,GAAG,KAAK,CAAC;AACpB,KAAK,UAAU,QAAQ;IACrB,IAAI,OAAO;QAAE,OAAO;IACpB,OAAO,GAAG,IAAI,CAAC;IACf,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAC9C,CAAC;AACD,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;AAC9C,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;AAC/C,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;AAE9C,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4CAA4C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5I,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/resources.d.ts

@@ -0,0 +1,49 @@
+import type { Resource as MCPResource, ReadResourceResult as MCPReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+type MCPServiceResponse<T> = {
+    success: boolean;
+    data?: T;
+    error?: string;
+    statusCode?: number;
+};
+export declare const FILESYSTEM_APP_URI = "ui://filesystem/browser";
+/**
+ * #216: the docked "dev canvas" diff app. A `pip`-capable, persistent surface
+ * that the mutation tools (`write_file`, `edit_file`) point their `_meta.ui`
+ * link at, so every edit feeds the SAME docked tab and updates in place instead
+ * of spawning a fresh iframe per write.
+ */
+export declare const DEVCANVAS_DIFF_URI = "ui://devcanvas/diff";
+/**
+ * #287: expose files the filesystem tools have read/written as MCP resources so
+ * a client can track which files a session touched. We keep a lightweight,
+ * bounded, newest-first in-memory registry of DESCRIPTORS (path, op, size,
+ * timestamp) — NOT copies of file bodies — and read the current content live
+ * (re-enforcing path confinement) only when a resource is actually read. That
+ * avoids duplicating potentially large/sensitive file contents into any store.
+ */
+export type TouchedFileOp = 'read' | 'write';
+/**
+ * Record that a filesystem tool touched `filePath`. Never throws — resource
+ * tracking must not be able to break a tool call.
+ */
+export declare function recordTouchedFile(filePath: string, op: TouchedFileOp, size?: number): void;
+/** Test seam: clear the touched-file registry. */
+export declare function _clearTouchedFilesForTests(): void;
+/** True when a URI refers to a tracked (read/written) file resource. */
+export declare function isTouchedFileUri(uri: string): boolean;
+/**
+ * resources/read for a tracked file: read the current content LIVE, re-enforcing
+ * the filesystem server's confinement roots (a file recorded earlier could now
+ * be outside a narrowed root). Content is capped like `read_file`.
+ */
+export declare function readTouchedFileResource(uri: string): Promise<MCPServiceResponse<MCPReadResourceResult>>;
+/** resources/list for the filesystem server: the browser app + diff canvas + tracked files. */
+export declare function filesystemListResources(): {
+    resources: MCPResource[];
+    error?: string;
+};
+/** True when a URI is one this module serves. */
+export declare function isFilesystemAppUri(uri: string): boolean;
+/** resources/read for the filesystem server's built-in MCP Apps. */
+export declare function filesystemReadResource(uri: string): MCPServiceResponse<MCPReadResourceResult>;
+export {};