@cyanheads/git-mcp-server 1.2.4

package/build/server.js

@@ -0,0 +1,120 @@
+/**
+ * Git MCP Server
+ * =============
+ *
+ * Main implementation of the Git MCP server.
+ */
+import { execSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+// Get the directory path of the current module
+import { fileURLToPath } from 'url';
+import { registerAllResources } from './resources/index.js';
+import { registerAllTools } from './tools/index.js';
+/**
+ * Git MCP Server class
+ *
+ * This class creates and manages an MCP server that exposes Git functionality
+ * through the Model Context Protocol, making it accessible to AI assistants
+ * and other MCP clients.
+ */
+export class GitMcpServer {
+    server;
+    /**
+     * Reads the package.json file to get metadata
+     */
+    getPackageInfo() {
+        // Get current file's directory and navigate to the project root
+        const __dirname = path.dirname(fileURLToPath(import.meta.url));
+        const packagePath = path.resolve(__dirname, '../package.json');
+        const packageContent = fs.readFileSync(packagePath, 'utf8');
+        return JSON.parse(packageContent);
+    }
+    /**
+     * Creates a new GitMcpServer instance
+     */
+    constructor() {
+        // Set up git config with global user settings
+        this.setupGitConfig();
+        // Get package info
+        const pkg = this.getPackageInfo();
+        // Initialize MCP server
+        this.server = new McpServer({
+            name: pkg.name,
+            version: pkg.version,
+            description: pkg.description
+        });
+        // Register all resources and tools
+        this.registerHandlers();
+        // Set up error handling
+        this.setupErrorHandling();
+    }
+    /**
+     * Sets up git config by setting environment variables for consistent author identity
+     * This ensures all git operations use the global git configuration
+     */
+    setupGitConfig() {
+        try {
+            // Get global git config values
+            const globalUserName = execSync('git config --global user.name').toString().trim();
+            const globalUserEmail = execSync('git config --global user.email').toString().trim();
+            // Set environment variables for git to use
+            // These variables will override any other configuration
+            process.env.GIT_AUTHOR_NAME = globalUserName;
+            process.env.GIT_AUTHOR_EMAIL = globalUserEmail;
+            process.env.GIT_COMMITTER_NAME = globalUserName;
+            process.env.GIT_COMMITTER_EMAIL = globalUserEmail;
+            console.error(`[Git MCP Server] Setting up git author identity: ${globalUserName} <${globalUserEmail}>`);
+        }
+        catch (error) {
+            console.error('Failed to set up git config:', error);
+        }
+    }
+    /**
+     * Registers all resource and tool handlers with the server
+     */
+    registerHandlers() {
+        // Register all resources (for providing Git data)
+        registerAllResources(this.server);
+        // Register all tools (for executing Git commands)
+        registerAllTools(this.server);
+        // Register resource descriptions
+        this.registerResourceDescriptions();
+    }
+    /**
+     * Registers resource descriptions for better client displays
+     */
+    registerResourceDescriptions() {
+        // This is a placeholder for resource descriptions
+        // In MCP SDK, descriptions need to be specified at resource registration time
+        // The actual descriptions are now defined in descriptors.ts and can be used
+        // by the individual resource registration methods
+        console.error('Resource descriptions are provided during resource registration');
+    }
+    /**
+     * Sets up global error handling for the server
+     */
+    setupErrorHandling() {
+        // Error handling will be done with try-catch in methods that can fail
+        process.on('uncaughtException', (error) => {
+            console.error(`[Git MCP Server Uncaught Exception] ${error.message}`);
+            console.error(error.stack);
+        });
+        process.on('unhandledRejection', (reason) => {
+            console.error(`[Git MCP Server Unhandled Rejection] ${reason instanceof Error ? reason.message : String(reason)}`);
+            if (reason instanceof Error && reason.stack) {
+                console.error(reason.stack);
+            }
+        });
+    }
+    /**
+     * Connects the server to a transport
+     *
+     * @param transport - MCP transport to connect to
+     * @returns Promise that resolves when connected
+     */
+    async connect(transport) {
+        await this.server.connect(transport);
+    }
+}

package/build/services/error-service.js

@@ -0,0 +1,73 @@
+/**
+ * Error Handling Service
+ * ======================
+ *
+ * Standardized error handling for Git operations and MCP server.
+ */
+/**
+ * Standardized error category classification
+ */
+export const ErrorCategoryType = {
+    CATEGORY_VALIDATION: 'VALIDATION',
+    CATEGORY_GIT: 'GIT',
+    CATEGORY_MCP: 'MCP',
+    CATEGORY_SYSTEM: 'SYSTEM',
+    CATEGORY_UNKNOWN: 'UNKNOWN'
+};
+/**
+ * Error severity classification
+ */
+export const ErrorSeverityLevel = {
+    SEVERITY_DEBUG: 0,
+    SEVERITY_INFO: 1,
+    SEVERITY_WARN: 2,
+    SEVERITY_ERROR: 3,
+    SEVERITY_FATAL: 4
+};
+/**
+ * Creates a standardized success result
+ */
+export function createSuccessResult(data) {
+    return { resultSuccessful: true, resultData: data };
+}
+/**
+ * Creates a standardized failure result
+ */
+export function createFailureResult(error) {
+    return { resultSuccessful: false, resultError: error };
+}
+/**
+ * Creates a standardized error object
+ */
+export function createStandardizedError(message, code, category, severity, context = {}) {
+    return {
+        errorMessage: message,
+        errorCode: code,
+        errorCategory: category,
+        errorSeverity: severity,
+        errorTimestamp: new Date().toISOString(),
+        errorContext: context
+    };
+}
+/**
+ * Converts an exception to a standardized error object
+ */
+export function wrapExceptionAsStandardizedError(exception, defaultMessage) {
+    const errorMessage = exception instanceof Error ? exception.message : defaultMessage;
+    const errorStack = exception instanceof Error ? exception.stack : undefined;
+    return {
+        errorMessage,
+        errorCode: 'UNEXPECTED_ERROR',
+        errorCategory: ErrorCategoryType.CATEGORY_UNKNOWN,
+        errorSeverity: ErrorSeverityLevel.SEVERITY_ERROR,
+        errorTimestamp: new Date().toISOString(),
+        errorContext: { originalException: exception },
+        errorStack
+    };
+}
+/**
+ * Handles Git-specific errors and converts them to standardized format
+ */
+export function createGitError(message, code, context = {}) {
+    return createStandardizedError(message, code, ErrorCategoryType.CATEGORY_GIT, ErrorSeverityLevel.SEVERITY_ERROR, context);
+}