@cyanheads/git-mcp-server 1.2.4

package/build/utils/validation.js

@@ -0,0 +1,108 @@
+/**
+ * Validation Utilities
+ * ===================
+ *
+ * Utilities for validating input parameters using Zod.
+ */
+import { z } from 'zod';
+import path from 'path';
+import { getGlobalSettings } from './global-settings.js';
+/**
+ * Common validation schemas used throughout the server
+ */
+export const Schemas = {
+    /**
+     * Repository path validation
+     */
+    repoPath: z.string()
+        .min(1, "Repository path is required")
+        .transform(val => path.normalize(val)),
+    /**
+     * Commit validation
+     */
+    commit: {
+        hash: z.string().regex(/^[0-9a-f]{4,40}$/, "Invalid commit hash format"),
+        message: z.string().min(1, "Commit message is required"),
+        author: z.object({
+            name: z.string().optional(),
+            email: z.string().email("Invalid email format").optional()
+        }).optional(),
+        date: z.date().optional(),
+        allowEmpty: z.boolean().optional().default(false),
+        amend: z.boolean().optional().default(false)
+    },
+    /**
+     * Branch validation
+     */
+    branch: {
+        name: z.string().min(1, "Branch name is required")
+            .regex(/^[^\s]+$/, "Branch name cannot contain spaces"),
+        checkout: z.boolean().optional().default(false),
+        startPoint: z.string().optional()
+    },
+    /**
+     * Remote validation
+     */
+    remote: {
+        name: z.string().min(1, "Remote name is required"),
+        url: z.string().url("Invalid URL format"),
+        branch: z.string().optional()
+    },
+    /**
+     * File validation
+     */
+    file: {
+        path: z.string().min(1, "File path is required"),
+        ref: z.string().optional().default('HEAD')
+    },
+    /**
+     * Diff validation
+     */
+    diff: {
+        fromRef: z.string().min(1, "Source reference is required"),
+        toRef: z.string().optional().default('HEAD'),
+        path: z.string().optional()
+    },
+    /**
+     * Tag validation
+     */
+    tag: {
+        name: z.string().min(1, "Tag name is required"),
+        message: z.string().optional(),
+        ref: z.string().optional()
+    }
+};
+/**
+ * Path validation helper functions
+ */
+export const PathValidation = {
+    /**
+     * Normalizes a path to ensure consistent format
+     * If path is "." and a global working directory is set, uses the global directory instead
+     */
+    normalizePath(inputPath) {
+        // Check if this is a relative path (like ".") and we have a global working dir set
+        if (inputPath === '.') {
+            const globalWorkingDir = getGlobalSettings().globalWorkingDir;
+            if (globalWorkingDir) {
+                return path.normalize(globalWorkingDir);
+            }
+        }
+        return path.normalize(inputPath);
+    },
+    /**
+     * Validates if a path is within the allowed directory
+     */
+    isWithinDirectory(targetPath, basePath) {
+        const normalizedTarget = path.normalize(targetPath);
+        const normalizedBase = path.normalize(basePath);
+        return normalizedTarget.startsWith(normalizedBase) &&
+            normalizedTarget.length > normalizedBase.length;
+    },
+    /**
+     * Joins and normalizes path components
+     */
+    joinPaths(...pathComponents) {
+        return path.normalize(path.join(...pathComponents));
+    }
+};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@cyanheads/git-mcp-server",
+  "version": "1.2.4",
+  "description": "A Model Context Protocol server for Git integration",
+  "type": "module",
+  "license": "Apache-2.0",
+  "author": "Casey Hand @cyanheads",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cyanheads/git-mcp-server"
+  },
+  "bin": {
+    "git-mcp-server": "./build/index.js"
+  },
+  "files": [
+    "build"
+  ],
+  "scripts": {
+    "build": "tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"",
+    "prepare": "npm run build",
+    "watch": "tsc --watch",
+    "inspector": "npx @modelcontextprotocol/inspector build/index.js",
+    "clean": "ts-node scripts/clean.ts",
+    "tree": "ts-node scripts/tree.ts",
+    "rebuild": "npm run clean && npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.8.0",
+    "dotenv": "^16.4.7",
+    "zod": "^3.24.2",
+    "@types/node": "^22.13.17",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.2",
+    "simple-git": "^3.27.0"
+  }
+}