#!/usr/bin/env python3 """ Консольная точка входа «mcp-sentinel» (ИБ 3.0). """ import argparse import json import sys from .sentinel import MCPSentinel, run_stdio_proxy __version__ = "1.1.2" def _shared_options_parser(suppress_defaults: bool) -> argparse.ArgumentParser: """ Родительский парсер с общими параметрами --ledger/-l и --agent/-a: переиспользуется через parents=[...] и основным парсером, и каждой подкомандой (check, wrap), поэтому оба флага принимаются как ДО имени подкоманды, так и ПОСЛЕ него. На подпарсерах default=argparse.SUPPRESS: если после подкоманды флаг не повторён, подпарсер не подставляет свой умолчательный default поверх значения, уже установленного (явно или по умолчанию) основным парсером до подкоманды. """ parent = argparse.ArgumentParser(add_help=False) ledger_default = argparse.SUPPRESS if suppress_defaults else "audit_fstec117.jsonl" agent_default = argparse.SUPPRESS if suppress_defaults else "ai-agent" parent.add_argument( "--ledger", "-l", default=ledger_default, help="Путь к криптографическому журналу ГОСТ Стрибог (по умолчанию: audit_fstec117.jsonl)", ) parent.add_argument( "--agent", "-a", default=agent_default, help="Идентификатор агента для протокола (по умолчанию: ai-agent)", ) return parent def build_parser() -> argparse.ArgumentParser: """Строит argparse-парсер CLI. Вынесено отдельно, чтобы тестировать parse_args() напрямую.""" top_parent = _shared_options_parser(suppress_defaults=False) sub_parent = _shared_options_parser(suppress_defaults=True) parser = argparse.ArgumentParser( prog="mcp-sentinel", description="Шлюз допустимости действий и Circuit Breaker для MCP-серверов (ИБ 3.0)", parents=[top_parent], ) parser.add_argument("--version", action="version", version=f"mcp-sentinel {__version__}") subparsers = parser.add_subparsers(dest="command", help="Команды") # check check_parser = subparsers.add_parser( "check", help="Тестовая проверка отдельного вызова инструмента", parents=[sub_parent], ) check_parser.add_argument("--tool", "-t", required=True, help="Имя инструмента (например: bash, execute_sql)") check_parser.add_argument( "--args", required=True, help='Аргументы вызова в формате JSON (например: \'{"path": "/etc/shadow"}\')', ) # wrap wrap_parser = subparsers.add_parser( "wrap", help="Запустить прозрачный прокси-шлюз перед дочерней командой MCP", parents=[sub_parent], ) wrap_parser.add_argument( "downstream", nargs=argparse.REMAINDER, help="Команда запуска целевого MCP сервера (после --)", ) return parser def main(): parser = build_parser() args = parser.parse_args() if not args.command: parser.print_help() sys.exit(1) if args.command == "check": sentinel = MCPSentinel(ledger_path=args.ledger) try: parsed_args = json.loads(args.args) except json.JSONDecodeError as e: print(f"[-] Ошибка парсинга JSON: {e}") sys.exit(1) allowed, reason, details = sentinel.validate_tool_call( agent_id=args.agent, tool_name=args.tool, arguments=parsed_args, ) if allowed: print("[+] ВЕРДИКТ: PERMIT (РАЗРЕШЕНО)") print(" Инварианты соблюдены, вызов безопасен.") sys.exit(0) else: print("[-] ВЕРДИКТ: BLOCK (ЗАБЛОКИРОВАНО)") print(f" Причина: {reason}") if details: print(f" Детали: {details}") sys.exit(2) elif args.command == "wrap": downstream = args.downstream if downstream and downstream[0] == "--": downstream = downstream[1:] if not downstream: print("[-] Ошибка: Не указана целевая команда для запуска MCP сервера.") sys.exit(1) run_stdio_proxy( downstream_cmd=downstream, agent_id=args.agent, ledger_path=args.ledger, ) if __name__ == "__main__": main()