Salesforce Deployment Guard MCP

Ein ausschließlich lokaler Server für das Model Context Protocol, der Salesforce-typische Deployment-Nachweise in strukturierte Befunde und Behebungsschritte umwandelt.

Dies ist ein Clean-Room-Portfolio-Projekt. Es verwendet deterministische Regeln und synthetische Beispiele – keine Salesforce-Org, keine Zugangsdaten, kein LLM, keine Telemetrie und kein Netzwerkzugriff.

Werkzeuge

Jedes Werkzeug ist schreibgeschützt und gibt sowohl menschenlesbaren Text als auch strukturiertes JSON zurück.

Related MCP server: VibeGuard MCP Server

Schnellstart

Voraussetzungen: Node.js 20.19 oder neuer.

git clone https://github.com/qpulce-dev/salesforce-deployment-guard-mcp.git
cd salesforce-deployment-guard-mcp
npm ci
npm run verify
npm run build

MCP-Client verbinden

Codex CLI:

codex mcp add salesforce-deployment-guard -- node "/absolute/path/to/salesforce-deployment-guard-mcp/dist/server.js"

Mit Claude Desktop kompatible Konfiguration:

{
  "mcpServers": {
    "salesforce-deployment-guard": {
      "command": "node",
      "args": [
        "/absolute/path/to/salesforce-deployment-guard-mcp/dist/server.js"
      ]
    }
  }
}

Nachdem Sie die MCP-Konfiguration geändert haben, starten Sie den Client neu.

Live-MCP-Transkript

Aufgezeichnet von einem echten MCP-Client, der über stdio mit dem erstellten Server verbunden ist:

connected: salesforce-deployment-guard-mcp
tools: analyze_deployment_log, validate_metadata_manifest, assess_permission_risk, build_remediation_plan
call: analyze_deployment_log
arguments: {"log":"Error: no CustomField named Demo__c.Region__c found"}
{
  "status": "issues_found",
  "findings": [
    {
      "code": "SF_MISSING_METADATA",
      "category": "missing_dependency",
      "severity": "error",
      "evidence": "Error: no CustomField named Demo__c.Region__c found",
      "likelyCause": "A referenced metadata component is absent from the deployment set or target org.",
      "nextChecks": [
        "Confirm the referenced component exists in source control.",
        "Add the dependency to the deployment manifest before its consumer."
      ]
    }
  ]
}

Das Verzeichnis fixtures/ enthält zusätzliche synthetische Eingaben.

Architektur

MCP client
  -> Zod input schema
  -> small tool handler
  -> deterministic domain function
  -> structured JSON + concise text

• src/server.ts registriert Werkzeuge und übernimmt den stdio-Start.

• src/domain/ enthält die reine Diagnose- und Planungslogik.

• src/tools/result.ts formatiert stabile MCP-Antworten.

• tests/ umfasst Domänenverhalten, Datenschutzregeln und einen echten stdio-MCP-Handshake.

• fixtures/ enthält ausschließlich synthetische Beispiele.

Verifikation

npm run verify

Dieser Befehl führt Formatierung, ESLint, strikte TypeScript-Prüfungen, 39 Tests, einen Produktions-Build und den Datenschutz-Scan aus. Der MCP-Smoke-Test startet den erstellten Server, handelt die Client-Verbindung aus, listet alle vier Werkzeuge auf und ruft ein Werkzeug auf.

CI führt dieselbe Verifikation unter Node.js 20.19 und 22 aus.

Datenschutz und Sicherheit

• Keine Netzwerkaufrufe zur Laufzeit.

• Keine Datenspeicherung oder Telemetrie.

• Keine Umgebungsvariablen oder Zugangsdaten erforderlich.

• Eingaben werden vor der Analyse begrenzt.

• Fehler geben keine Stack-Traces oder lokalen Pfade zurück.

• Enthaltene Beispiele verwenden Namen wie Demo__c und Demo_Access.

• Der Datenschutz-Scanner meldet nur Datei- und Regelkennungen, niemals den tatsächlich übereinstimmenden Geheimtext.

Zur zusätzlichen lokalen Prüfung des Organisationsnamens:

PRIVATE_ORG_NAMES="Private Org One,Private Org Two" npm run privacy:scan

Fügen Sie keine echten Produktionsprotokolle in öffentliche Issues, Commits oder Fixtures ein.

Einschränkungen

Dieser Server bietet deterministische Prüfempfehlungen. Er verbindet sich nicht mit Salesforce, validiert keine Live-Org, ersetzt kein Sicherheitsreview und garantiert keinen Deployment-Erfolg. Unbekannte Nachweise bleiben als unknown klassifiziert.

Lizenz

MIT © 2026 Queanu Pulce