mcp-perforce-server 1.0.0

package/dist/tools/utils.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * Additional utility tools for MCP Perforce server
+ */
+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.p4Filelog = p4Filelog;
+exports.p4Clients = p4Clients;
+exports.p4ConfigDetect = p4ConfigDetect;
+const parse = __importStar(require("../p4/parse.js"));
+/**
+ * p4 filelog - Show file history
+ */
+async function p4Filelog(context, args) {
+    if (!args.filespec) {
+        return {
+            ok: false,
+            command: 'filelog',
+            args: [],
+            cwd: process.cwd(),
+            configUsed: {},
+            error: {
+                code: 'P4_INVALID_ARGS',
+                message: 'filespec parameter is required',
+            },
+        };
+    }
+    const { cwd, env, configResult } = await context.config.setupForCommand(args.workspacePath);
+    const cmdArgs = [];
+    if (args.maxRevisions && args.maxRevisions > 0) {
+        cmdArgs.push('-m', args.maxRevisions.toString());
+    }
+    cmdArgs.push(args.filespec);
+    const result = await context.runner.run('filelog', cmdArgs, cwd, {
+        env,
+        useZtag: false,
+        parseOutput: true,
+    });
+    if (result.ok && result.result) {
+        result.result = parse.parseFilelogOutput(result.result);
+    }
+    result.configUsed = {
+        ...result.configUsed,
+        p4configPath: configResult.configPath,
+    };
+    return result;
+}
+/**
+ * p4 clients - List Perforce clients/workspaces
+ */
+async function p4Clients(context, args = {}) {
+    const { cwd, env, configResult } = await context.config.setupForCommand(args.workspacePath);
+    const cmdArgs = [];
+    if (args.user) {
+        cmdArgs.push('-u', args.user);
+    }
+    const result = await context.runner.run('clients', cmdArgs, cwd, {
+        env,
+        useZtag: false,
+        parseOutput: true,
+    });
+    if (result.ok && result.result) {
+        result.result = parse.parseClientsOutput(result.result);
+    }
+    result.configUsed = {
+        ...result.configUsed,
+        p4configPath: configResult.configPath,
+    };
+    return result;
+}
+/**
+ * p4.config.detect - Detect and show Perforce configuration
+ */
+async function p4ConfigDetect(context, args = {}) {
+    const startPath = args.workspacePath || process.cwd();
+    try {
+        const configResult = await context.config.findConfig(startPath);
+        const validation = context.config.validateEnvironment(configResult);
+        // Get MCP environment variables
+        const mcpEnv = {};
+        const p4Keys = ['P4PORT', 'P4USER', 'P4CLIENT', 'P4CHARSET', 'P4PASSWD'];
+        for (const key of p4Keys) {
+            if (process.env[key]) {
+                mcpEnv[key] = process.env[key];
+            }
+        }
+        const result = {
+            ok: true,
+            command: 'config.detect',
+            args: [],
+            cwd: startPath,
+            configUsed: {
+                p4configPath: configResult.configPath,
+                ...configResult.environment,
+            },
+            result: {
+                found: configResult.found,
+                configPath: configResult.configPath,
+                projectRoot: configResult.projectRoot,
+                config: configResult.config,
+                environment: configResult.environment,
+                mcpEnvironment: mcpEnv,
+                validation: {
+                    valid: validation.valid,
+                    errors: validation.errors,
+                },
+                searchPath: startPath,
+                configurationSource: configResult.found ? '.p4config file' :
+                    Object.keys(mcpEnv).length > 0 ? 'MCP environment variables' :
+                        'none',
+            },
+        };
+        if (!validation.valid) {
+            result.warnings = validation.errors;
+        }
+        return result;
+    }
+    catch (error) {
+        return {
+            ok: false,
+            command: 'config.detect',
+            args: [],
+            cwd: startPath,
+            configUsed: {},
+            error: {
+                code: 'P4_CONFIG_NOT_FOUND',
+                message: `Failed to detect configuration: ${error}`,
+            },
+        };
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/tools/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeH,8BA0CC;AAKD,8BA2BC;AAKD,wCAgEC;AA1JD,sDAAwC;AAQxC;;GAEG;AACI,KAAK,UAAU,SAAS,CAC7B,OAAoB,EACpB,IAAyE;IAEzE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,SAAS;YAClB,IAAI,EAAE,EAAE;YACR,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,UAAU,EAAE,EAAE;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,gCAAgC;aAC1C;SACF,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAE5F,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE5B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE;QAC/D,GAAG;QACH,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,IAAI;KAClB,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAC/B,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAgB,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,UAAU,GAAG;QAClB,GAAG,MAAM,CAAC,UAAU;QACpB,YAAY,EAAE,YAAY,CAAC,UAAU;KACtC,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,SAAS,CAC7B,OAAoB,EACpB,OAAkD,EAAE;IAEpD,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAE5F,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE;QAC/D,GAAG;QACH,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,IAAI;KAClB,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAC/B,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAgB,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,UAAU,GAAG;QAClB,GAAG,MAAM,CAAC,UAAU;QACpB,YAAY,EAAE,YAAY,CAAC,UAAU;KACtC,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,cAAc,CAClC,OAAoB,EACpB,OAAmC,EAAE;IAErC,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAEtD,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;QAEpE,gCAAgC;QAChC,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QACzE,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAgB;YAC1B,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,eAAe;YACxB,IAAI,EAAE,EAAE;YACR,GAAG,EAAE,SAAS;YACd,UAAU,EAAE;gBACV,YAAY,EAAE,YAAY,CAAC,UAAU;gBACrC,GAAG,YAAY,CAAC,WAAW;aAC5B;YACD,MAAM,EAAE;gBACN,KAAK,EAAE,YAAY,CAAC,KAAK;gBACzB,UAAU,EAAE,YAAY,CAAC,UAAU;gBACnC,WAAW,EAAE,YAAY,CAAC,WAAW;gBACrC,MAAM,EAAE,YAAY,CAAC,MAAM;gBAC3B,WAAW,EAAE,YAAY,CAAC,WAAW;gBACrC,cAAc,EAAE,MAAM;gBACtB,UAAU,EAAE;oBACV,KAAK,EAAE,UAAU,CAAC,KAAK;oBACvB,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B;gBACD,UAAU,EAAE,SAAS;gBACrB,mBAAmB,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;oBACzC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC;wBAC9D,MAAM;aAC1B;SACF,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACtB,MAAM,CAAC,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC;QACtC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,eAAe;YACxB,IAAI,EAAE,EAAE;YACR,GAAG,EAAE,SAAS;YACd,UAAU,EAAE,EAAE;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EAAE,mCAAmC,KAAK,EAAE;aACpD;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "mcp-perforce-server",
+  "version": "1.0.0",
+  "description": "Enterprise-grade MCP (Model Context Protocol) server for Perforce P4 integration with AI assistants like Claude, ChatGPT, and VS Code. Created by Pratik Bhuite using vibe coding to solve real-world Perforce automation challenges. Open source, customizable, and community-driven.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "perforce",
+    "p4",
+    "p4v",
+    "vcs",
+    "version-control",
+    "ai",
+    "automation",
+    "claude",
+    "chatgpt",
+    "vscode",
+    "cursor",
+    "anthropic",
+    "openai",
+    "git",
+    "scm",
+    "devops",
+    "enterprise",
+    "developer-tools",
+    "code-assistant",
+    "ai-integration",
+    "workflow-automation",
+    "typescript",
+    "cross-platform",
+    "windows",
+    "macos",
+    "linux",
+    "production-ready",
+    "secure",
+    "open-source",
+    "community",
+    "customizable",
+    "vibe-coding"
+  ],
+  "homepage": "https://github.com/iPraBhu/mcp-perforce-server#readme",
+  "bugs": {
+    "url": "https://github.com/iPraBhu/mcp-perforce-server/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iPraBhu/mcp-perforce-server.git"
+  },
+  "license": "MIT",
+  "author": "Pratik Bhuite (https://github.com/iPraBhu)",
+  "type": "commonjs",
+  "main": "dist/server.js",
+  "types": "./dist/server.d.ts",
+  "bin": {
+    "mcp-perforce-server": "dist/server.js"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "MCP_CONFIG_EXAMPLES.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc && node dist/server.js",
+    "start": "node dist/server.js",
+    "watch": "tsc --watch",
+    "clean": "rimraf dist",
+    "test": "node test-server.js",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "rimraf": "^5.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}