filesystem-mcp 1.0.0 → 1.2.0

package/dist/tools/create.js

@@ -38,6 +38,8 @@ const zod_1 = require("zod");
 const fs = __importStar(require("node:fs/promises"));
 const path = __importStar(require("node:path"));
 const response_js_1 = require("../utils/response.js");
+const paths_js_1 = require("../utils/paths.js");
+const schema_js_1 = require("../utils/schema.js");
 const description = `Create or overwrite a file with the specified content.
 
 - Creates parent directories if they don't exist
@@ -47,17 +49,19 @@ function registerCreate(server) {
     server.registerTool('create', {
         title: 'Create',
         description,
-        inputSchema: {
+        inputSchema: (0, schema_js_1.strictSchemaWithAliases)({
             path: zod_1.z.string().describe('Absolute path where file will be created'),
-            file_text: zod_1.z.string().describe('Content to write to the file'),
-        },
+            content: zod_1.z.string().describe('Content to write to the file'),
+        }, {
+            file_text: 'content',
+        }),
         annotations: {
             readOnlyHint: false,
             destructiveHint: true,
         },
     }, async (args) => {
-        const targetPath = args.path;
-        const content = args.file_text;
+        const targetPath = (0, paths_js_1.expandPath)(args.path);
+        const { content } = args;
         // Create parent directories if needed
         const dir = path.dirname(targetPath);
         await fs.mkdir(dir, { recursive: true });

package/dist/tools/insert.js

@@ -37,34 +37,40 @@ exports.registerInsert = registerInsert;
 const zod_1 = require("zod");
 const fs = __importStar(require("node:fs/promises"));
 const response_js_1 = require("../utils/response.js");
+const paths_js_1 = require("../utils/paths.js");
+const schema_js_1 = require("../utils/schema.js");
 const description = `Insert text at a specific line in a file.
 
 - insert_line = 0: Insert at the beginning
 - insert_line = N: Insert after line N
+- insert_line = -1: Insert at the end
 - insert_text should typically end with a newline
 - Use absolute paths`;
 function registerInsert(server) {
     server.registerTool('insert', {
         title: 'Insert',
         description,
-        inputSchema: {
+        inputSchema: (0, schema_js_1.strictSchemaWithAliases)({
             path: zod_1.z.string().describe('Absolute path to file'),
-            insert_line: zod_1.z.number().int().min(0).describe('Line number to insert after (0 = beginning)'),
+            insert_line: zod_1.z.number().int().min(-1).describe('Line number to insert after (0 = beginning, -1 = end)'),
             insert_text: zod_1.z.string().describe('Text to insert (should end with newline)'),
-        },
+        }, {}),
         annotations: {
             readOnlyHint: false,
             destructiveHint: true,
         },
     }, async (args) => {
-        const targetPath = args.path;
-        const insertLine = args.insert_line;
+        const targetPath = (0, paths_js_1.expandPath)(args.path);
         const insertText = args.insert_text;
         const content = await fs.readFile(targetPath, 'utf-8');
         const lines = content.split('\n');
+        // Handle -1 as "end of file"
+        // If file ends with newline, insert before the trailing empty element
+        const endPosition = content.endsWith('\n') ? lines.length - 1 : lines.length;
+        const insertLine = args.insert_line === -1 ? endPosition : args.insert_line;
         // Validate line number
         if (insertLine > lines.length) {
-            throw new Error(`insert_line ${insertLine} is beyond file length (${lines.length} lines)`);
+            throw new Error(`insert_line ${args.insert_line} is beyond file length (${lines.length} lines)`);
         }
         // Warn if insert_text doesn't end with newline
         let warning;

package/dist/tools/str-replace.js

@@ -37,6 +37,8 @@ exports.registerStrReplace = registerStrReplace;
 const zod_1 = require("zod");
 const fs = __importStar(require("node:fs/promises"));
 const response_js_1 = require("../utils/response.js");
+const paths_js_1 = require("../utils/paths.js");
+const schema_js_1 = require("../utils/schema.js");
 const description = `Replace an exact string in a file.
 
 - old_str must match exactly and be unique in the file
@@ -47,17 +49,20 @@ function registerStrReplace(server) {
     server.registerTool('str_replace', {
         title: 'String Replace',
         description,
-        inputSchema: {
+        inputSchema: (0, schema_js_1.strictSchemaWithAliases)({
             path: zod_1.z.string().describe('Absolute path to file'),
             old_str: zod_1.z.string().describe('Exact string to find (must be unique)'),
             new_str: zod_1.z.string().optional().describe('Replacement string (omit to delete)'),
-        },
+        }, {
+            old_string: 'old_str',
+            new_string: 'new_str',
+        }),
         annotations: {
             readOnlyHint: false,
             destructiveHint: true,
         },
     }, async (args) => {
-        const targetPath = args.path;
+        const targetPath = (0, paths_js_1.expandPath)(args.path);
         const oldStr = args.old_str;
         const newStr = args.new_str ?? '';
         const content = await fs.readFile(targetPath, 'utf-8');

package/dist/tools/view.js

@@ -38,6 +38,8 @@ const zod_1 = require("zod");
 const fs = __importStar(require("node:fs/promises"));
 const path = __importStar(require("node:path"));
 const response_js_1 = require("../utils/response.js");
+const paths_js_1 = require("../utils/paths.js");
+const schema_js_1 = require("../utils/schema.js");
 const description = `View file contents or list directory.
 
 For files:
@@ -53,15 +55,15 @@ function registerView(server) {
     server.registerTool('view', {
         title: 'View',
         description,
-        inputSchema: {
+        inputSchema: (0, schema_js_1.strictSchemaWithAliases)({
             path: zod_1.z.string().describe('Absolute path to file or directory'),
             view_range: zod_1.z.tuple([zod_1.z.number(), zod_1.z.number()]).optional().describe('Line range [start, end] for text files (1-indexed, inclusive)'),
-        },
+        }, {}),
         annotations: {
             readOnlyHint: true,
         },
     }, async (args) => {
-        const targetPath = args.path;
+        const targetPath = (0, paths_js_1.expandPath)(args.path);
         const stat = await fs.stat(targetPath);
         if (stat.isDirectory()) {
             const entries = await listDirectory(targetPath, 2);

package/dist/utils/paths.d.ts

@@ -0,0 +1 @@
+export declare function expandPath(p: string): string;

package/dist/utils/paths.js

@@ -0,0 +1,46 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expandPath = expandPath;
+const os = __importStar(require("node:os"));
+function expandPath(p) {
+    if (p.startsWith('~/')) {
+        return p.replace('~', os.homedir());
+    }
+    if (p === '~') {
+        return os.homedir();
+    }
+    return p;
+}

package/dist/utils/schema.d.ts

@@ -0,0 +1,9 @@
+import { type ZodRawShape, type ZodTypeAny } from 'zod';
+type AliasMap = Record<string, string>;
+/**
+ * Creates a strict Zod object schema that:
+ * 1. Accepts aliased parameter names (e.g., new_string -> new_str)
+ * 2. Rejects any unknown parameters after alias resolution
+ */
+export declare function strictSchemaWithAliases<T extends ZodRawShape>(shape: T, aliases?: AliasMap): ZodTypeAny;
+export {};

package/dist/utils/schema.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.strictSchemaWithAliases = strictSchemaWithAliases;
+const zod_1 = require("zod");
+/**
+ * Creates a strict Zod object schema that:
+ * 1. Accepts aliased parameter names (e.g., new_string -> new_str)
+ * 2. Rejects any unknown parameters after alias resolution
+ */
+function strictSchemaWithAliases(shape, aliases = {}) {
+    const objectSchema = zod_1.z.object(shape).strict();
+    return zod_1.z.preprocess((args) => {
+        if (typeof args !== 'object' || args === null) {
+            return args;
+        }
+        const input = args;
+        const result = {};
+        // Build result object, mapping aliases to canonical names
+        for (const key of Object.keys(input)) {
+            const canonicalKey = aliases[key] ?? key;
+            // Only use alias if canonical key isn't already set
+            if (!(canonicalKey in result)) {
+                result[canonicalKey] = input[key];
+            }
+        }
+        return result;
+    }, objectSchema);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "filesystem-mcp",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "MCP server for filesystem operations (view, create, edit files)",
   "license": "MIT",
   "author": "Adam Jones (domdomegg)",
@@ -32,7 +32,8 @@
     "eslint-config-domdomegg": "^2.0.0",
     "tsconfig-domdomegg": "^1.0.0",
     "typescript": "^5.8.0",
-    "vitest": "^3.0.0"
+    "vitest": "^3.0.0",
+    "zod-to-json-schema": "^3.25.1"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.24.0",