MCP MGit Server

Instructions

Implementation Reference

• src/server-final.js:231-325 (handler)

  The main handler function `mgit_push` that implements the tool logic: validates `message` param, enforces push history check if enabled, calls `executeMgitPush`, logs and records history, returns structured result or throws on error.

  async mgit_push(params) {
    const { message } = params;
  
    if (!message || typeof message !== 'string') {
      throw new Error('Missing message parameter');
    }
  
    // Check if push history has been checked (only if CHECK_PUSH_HISTORY is enabled)
    if (CHECK_PUSH_HISTORY && !this.hasCheckedPushHistory) {
      // Get the actual tool name (with prefix if REPO_NAME is set)
      const pushHistoryToolName = REPO_NAME ? `${REPO_NAME}_get_push_history` : 'get_push_history';
      const pushToolName = REPO_NAME ? `${REPO_NAME}_mgit_push` : 'mgit_push';
      
      // Return JSON-RPC 2.0 compliant result with multiple prompt messages
      return {
        content: [
          {
            type: 'text',
            text: '⚠️ ERROR: Push history check is required before pushing code.'
          },
          {
            type: 'text',
            text: `🔧 REQUIRED ACTION: You must call the "${pushHistoryToolName}" tool first to view recent push records.`
          },
          {
            type: 'text',
            text: `📋 TOOL NAME: "${pushHistoryToolName}" - Use this tool to get the last 5 push history records.`
          },
          {
            type: 'text',
            text: `📝 TOOL CALL EXAMPLE: Call tools/call with name="${pushHistoryToolName}" and empty arguments: {"name": "${pushHistoryToolName}", "arguments": {}}`
          },
          {
            type: 'text',
            text: '🔍 STEP 1: Call get_push_history tool to view the last 5 push records for this repository.'
          },
          {
            type: 'text',
            text: '📊 STEP 2: Review the push history records to see what has been pushed recently.'
          },
          {
            type: 'text',
            text: '✅ STEP 3: Confirm that the changes you want to push have NOT been pushed before by comparing with the history.'
          },
          {
            type: 'text',
            text: '🔄 STEP 4: If the changes have already been pushed, modify the commit message to reflect new changes, then try again.'
          },
          {
            type: 'text',
            text: `🚀 STEP 5: After reviewing and confirming, you can then call "${pushToolName}" tool to proceed with the push.`
          },
          {
            type: 'text',
            text: `⚠️ IMPORTANT: The "${pushHistoryToolName}" tool must be called before "${pushToolName}" tool, otherwise the push will be rejected.`
          }
        ],
        isError: true,
        errorCode: 'PUSH_HISTORY_CHECK_REQUIRED'
      };
    }
  
    try {
      const result = await executeMgitPush(message);
      
      // Log operation
      logRequest('mgit_push', { repo_name: REPO_NAME, message }, result);
  
      // Record push history
      recordPushHistory(message, result, null);
  
      // Reset the flag after successful push
      this.hasCheckedPushHistory = false;
  
      return {
        success: true,
        repo_name: REPO_NAME,
        message: message,
        output: result.stdout,
        error_output: result.stderr,
        exit_code: result.exitCode
      };
    } catch (err) {
      // Log operation error
      logRequest('mgit_push', { repo_name: REPO_NAME, message }, null, err.error || err.message);
      
      // Record push history even on error
      recordPushHistory(message, null, err.error || err.message);
  
      // Reset the flag after error
      this.hasCheckedPushHistory = false;
      
      throw new Error(`MGit push failed: ${err.error || err.message}`);
    }
  }

• src/server-final.js:138-202 (helper)

  Helper function `executeMgitPush` that spawns the `mgit push <repo> <message>` subprocess, captures output streams and exit code, resolves success or rejects with error details.

  const executeMgitPush = async (message) => {
    return new Promise((resolve, reject) => {
      const command = MGIT_CMD;
      // Clean the message: remove or escape problematic characters
      // Remove double quotes from the message to avoid argument parsing issues
      // Replace double quotes with single quotes or remove them
      const cleanedMessage = message.replace(/"/g, "'");
      
      // When using spawn with array args, we don't need quotes
      // The message will be passed as a single argument even if it contains spaces
      const args = ['push', REPO_NAME, cleanedMessage];
      
      console.error(`Executing: ${command} ${args.map(arg => arg.includes(' ') ? `"${arg}"` : arg).join(' ')}`);
      
      // Use shell: false to pass arguments directly without shell interpretation
      // This ensures the message is passed as a single argument even with spaces
      const child = spawn(command, args, {
        stdio: ['inherit', 'pipe', 'pipe'],
        shell: false
      });
  
      let stdout = '';
      let stderr = '';
  
      child.stdout.on('data', (data) => {
        const output = data.toString();
        stdout += output;
        console.error(output);
      });
  
      child.stderr.on('data', (data) => {
        const output = data.toString();
        stderr += output;
        console.error(output);
      });
  
      child.on('close', (code) => {
        if (code === 0) {
          resolve({
            success: true,
            stdout: stdout,
            stderr: stderr,
            exitCode: code
          });
        } else {
          reject({
            success: false,
            stdout: stdout,
            stderr: stderr,
            exitCode: code,
            error: `Command exited with code ${code}`
          });
        }
      });
  
      child.on('error', (err) => {
        reject({
          success: false,
          error: err.message,
          stdout: stdout,
          stderr: stderr
        });
      });
    });
  };

• src/server-final.js:457-483 (registration)

  Tool registration in `tools/list` method: defines the tool name as `${REPO_NAME}_mgit_push` (e.g., 'my-project-repo_mgit_push'), detailed description, and input schema requiring 'message' string.

              {
                name: getToolName('mgit_push'),
                description: getToolDescription(`Execute ${MGIT_CMD} push command for repository "${REPO_NAME}" with a commit message. 
  
  IMPORTANT: 
  ${CHECK_PUSH_HISTORY ? '- You MUST call get_push_history tool FIRST to view the last 5 push records before using this tool\n- Confirm that the changes in this push have not been pushed before, otherwise modify the push message and push again\n' : ''}- The repository name is configured via REPO_NAME environment variable
  - Language setting: ${LANGUAGE} (default: en)
  ${CHECK_PUSH_HISTORY ? '- Push history check is enabled (CHECK_PUSH_HISTORY=true). You must review push history before pushing.\n' : '- Push history check is disabled (CHECK_PUSH_HISTORY=false). You can push directly without checking history.\n'}
  
  USAGE: 
  ${CHECK_PUSH_HISTORY ? '1. First call get_push_history to view recent push records\n2. ' : ''}Then call this tool with the commit message parameter. Example:
  {message: "${LANGUAGE === 'en' ? 'Update project files' : LANGUAGE === 'zh' || LANGUAGE === 'zh-CN' ? '更新项目文件' : LANGUAGE === 'zh-TW' ? '更新專案檔案' : 'Update project files'}"}
  
  Please provide the commit message in ${LANGUAGE === 'en' ? 'English' : LANGUAGE === 'zh' || LANGUAGE === 'zh-CN' ? 'Chinese' : LANGUAGE === 'zh-TW' ? 'Traditional Chinese' : LANGUAGE} language.
  
  NOTE: If the push result contains a branch merge URL (such as a pull request URL), please output it to the user. If you can open a browser, you may also automatically open the URL.`),
                inputSchema: {
                  type: 'object',
                  properties: {
                    message: {
                      type: 'string',
                      description: `Commit message in ${LANGUAGE === 'en' ? 'English' : LANGUAGE === 'zh' || LANGUAGE === 'zh-CN' ? 'Chinese' : LANGUAGE === 'zh-TW' ? 'Traditional Chinese' : LANGUAGE} language. Example: {message: "${LANGUAGE === 'en' ? 'Update project files' : LANGUAGE === 'zh' || LANGUAGE === 'zh-CN' ? '更新项目文件' : LANGUAGE === 'zh-TW' ? '更新專案檔案' : 'Update project files'}"}`
                    }
                  },
                  required: ['message']
                }
              }

• src/server-final.js:473-482 (schema)

  Input schema definition for the tool: object with required 'message' property of type string, including language-specific description and example.

  inputSchema: {
    type: 'object',
    properties: {
      message: {
        type: 'string',
        description: `Commit message in ${LANGUAGE === 'en' ? 'English' : LANGUAGE === 'zh' || LANGUAGE === 'zh-CN' ? 'Chinese' : LANGUAGE === 'zh-TW' ? 'Traditional Chinese' : LANGUAGE} language. Example: {message: "${LANGUAGE === 'en' ? 'Update project files' : LANGUAGE === 'zh' || LANGUAGE === 'zh-CN' ? '更新项目文件' : LANGUAGE === 'zh-TW' ? '更新專案檔案' : 'Update project files'}"}`
      }
    },
    required: ['message']
  }

• src/server-final.js:603-606 (helper)

  Helper logic in `tools/call` handler that strips the repo prefix (e.g., 'my-project-repo_') from tool name to map to internal `mgit_push` method.

  let actualMethodName = name;
  if (REPO_NAME && name.startsWith(`${REPO_NAME}_`)) {
    actualMethodName = name.substring(REPO_NAME.length + 1);
  }