filesystem-mcp 1.0.0 → 1.1.0

package/dist/tools/create.js

@@ -38,6 +38,7 @@ 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 description = `Create or overwrite a file with the specified content.
 
 - Creates parent directories if they don't exist
@@ -49,15 +50,15 @@ function registerCreate(server) {
         description,
         inputSchema: {
             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'),
         },
         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,10 +37,12 @@ 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 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) {
@@ -49,7 +51,7 @@ function registerInsert(server) {
         description,
         inputSchema: {
             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: {
@@ -57,14 +59,17 @@ function registerInsert(server) {
             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,7 @@ 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 description = `Replace an exact string in a file.
 
 - old_str must match exactly and be unique in the file
@@ -57,7 +58,7 @@ function registerStrReplace(server) {
             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,7 @@ 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 description = `View file contents or list directory.
 
 For files:
@@ -61,7 +62,7 @@ function registerView(server) {
             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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "filesystem-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP server for filesystem operations (view, create, edit files)",
   "license": "MIT",
   "author": "Adam Jones (domdomegg)",