Salesforce Deployment Guard MCP

Локальный сервер Model Context Protocol, который преобразует результаты развертывания Salesforce в структурированные выводы и шаги по исправлению.

Это чистый портфельный проект. Он использует детерминированные правила и синтетические примеры — без Salesforce-организации, учетных данных, LLM, телеметрии или сетевого доступа.

Инструменты

Каждый инструмент доступен только для чтения и возвращает как читаемый текст, так и структурированный JSON.

Related MCP server: VibeGuard MCP Server

Быстрый старт

Требования: Node.js 20.19 или новее.

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-клиента

CLI Codex:

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

Конфигурация, совместимая с Claude Desktop:

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

Перезапустите клиент после изменения его MCP-конфигурации.

Живая MCP-транскрипция

Записана с реального MCP-клиента, подключенного к запущенному серверу через stdio:

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."
      ]
    }
  ]
}

Каталог fixtures/ содержит дополнительные синтетические входные данные.

Архитектура

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

• src/server.ts регистрирует инструменты и управляет запуском через stdio.

• src/domain/ содержит чистую логику диагностики и планирования.

• src/tools/result.ts форматирует стабильные MCP-ответы.

• tests/ покрывает поведение домена, правила конфиденциальности и реальный MCP-хендшейк через stdio.

• fixtures/ содержит только синтетические примеры.

Проверка

npm run verify

Эта команда запускает форматирование, ESLint, строгую проверку TypeScript, 39 тестов, production-сборку и проверку конфиденциальности. MCP-смоук-тест запускает собранный сервер, выполняет хендшейк с клиентом, выводит список всех четырех инструментов и вызывает один инструмент.

CI выполняет ту же проверку на Node.js 20.19 и 22.

Конфиденциальность и безопасность

• Никаких сетевых вызовов во время выполнения.

• Никакого хранения данных или телеметрии.

• Никаких переменных окружения или учетных данных не требуется.

• Входные данные ограничены до анализа.

• Ошибки не возвращают трассировки стека или локальные пути.

• Включенные примеры используют имена, такие как Demo__c и Demo_Access.

• Сканер конфиденциальности сообщает только идентификаторы файлов и правил, но никогда не сообщает совпавший секретный текст.

Для дополнительной локальной проверки имени организации:

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

Не вставляйте реальные production-логи в публичные проблемы, коммиты или фикстуры.

Ограничения

Этот сервер предоставляет детерминированные рекомендации по проверке. Он не подключается к Salesforce, не выполняет проверку в реальной организации, не заменяет проверку безопасности и не гарантирует успех развертывания. Неизвестные свидетельства остаются классифицированными как unknown.

Лицензия

MIT © 2026 Queanu Pulce