Chimera-Protocol/csl-core

Chimera-Protocol/csl-core

от chimera-protocol
MCP-сервер для написания и верификации политик безопасности AI-агентов. Правила описываются в CSL, проходят формальную проверку через Z3 и применяются детерминированно, без оглядки на промпты. Поле...

CSL-Core

PyPI version PyPI Downloads Python License Z3 Verified TLA+ Verified

Find, prove and control the AI agents on your machines.

CSL-Core finds every AI agent on a host and what it can reach, writes a policy for each one, proves the policies with Z3 and TLA+, tests the code that connects agents to policies against bypass tricks, and enforces them deterministically, outside the model. The model never sees the rules, so it cannot talk its way past them.

cslcore venom: discovery of the AI agents on a host

Quick start

pip install csl-core
cslcore setup

cslcore setup is the whole first install: it scans the machine, explains what it found, and opens the protection board, the riskiest agents first. Enter gives every agent standard limits, a policy made from them and checked with Z3, and the change that puts the guard in its call path, shown as a diff with a one-line summary before anything is written. A number opens one agent instead: its limits in your own numbers (amounts, any numeric argument, allow, approval or block per tool), the policy, the wiring and a check that decides sample calls with the real policy and shows what runs and what stops. Until you confirm a wiring change it writes only inside the folder you run it in. It is resumable at any step, and cslcore setup later opens the board where you left it.

Часто задаваемые вопросы

Инструменты были проиндексированы:
explain_policy

Разбирает политику CSL и возвращает структурированную сводку в Markdown. Показывает: доменное имя, все переменные с типами/диапазонами, все ограничения с триггерами и действиями, а также настройки конфигурации. Не компилирует и не проверяет: используйте verify_policy для этого. Args: csl_content: полный исходный код политики CSL в виде строки.

Параметры
  • csl_contentstringобязательный
scaffold_policy

Генерирует каркас политики CSL на основе описания. Возвращает готовый к редактированию шаблон .csl с CONFIG, DOMAIN, VARIABLES и заполнителями ограничений. Типовые шаблоны CSL: WHEN amount > 1000 THEN role MUST BE "ADMIN" WHEN risk_score > 0.8 THEN action MUST NOT BE "TRANSFER" ALWAYS True THEN tool MUST NOT BE "DELETE" WHEN user_age < 18 AND category == "ALCOHOL" THEN allowed MUST BE "NO" Типы переменных: amount: 0..100000 (integer range) role: {"ADMIN", "USER"} (enum / string set) score: 0..1 (numeric range) Параметры: domain_name: Название домена политики (например, "PaymentGuard", "AgentSafety"). description: Описание на простом английском, что должна обеспечивать политика. variables: Необязательные подсказки по переменным через запятую (например, "amount, role, risk_score").

Параметры
  • descriptionstringобязательный
  • domain_namestringобязательный
  • variablesstring
simulate_policy

Симулирует политику CSL для одного или нескольких JSON-входов. Компилирует политику, затем запускает runtime guard для предоставленного контекста. Возвращает ALLOWED или BLOCKED с полными деталями нарушения. Поддерживает пакетную симуляцию: принимает JSON-массив объектов для тестирования нескольких входов. Аргументы: csl_content: Полный исходный код политики CSL в виде строки. context_json: JSON-объект (один вход) или JSON-массив (пакет) для тестирования. dry_run: Если true, оценивает все правила, но никогда не блокирует. Полезно для теневого тестирования.

Параметры
  • context_jsonstringобязательный
  • csl_contentstringобязательный
  • dry_runboolean
tla_verify

Запускает формальную верификацию TLA+ (настоящий TLC model checking) для CSL-политики. Выполняет исчерпывающий перебор пространства состояний для проверки свойств темпоральной безопасности. В отличие от Z3 (который проверяет статическую логическую согласованность), TLA+ проверяет ВСЕ возможные переходы состояний во времени. Возвращает: - Истинность всех свойств безопасности - Количество исследованных состояний / уникальных состояний - Трассы-контрпримеры для любых нарушений - Доказательство идентичности TLC (версия, PID, рабочие процессы) - Автоматические предложения по исправлению нарушений - Сгенерированная спецификация TLA+ (для прозрачности) Используйте verify_policy для быстрых проверок согласованности в Z3. Используйте tla_verify, когда требуется исчерпывающая темпоральная верификация. Аргументы: csl_content: Полный исходный код CSL-политики в виде строки. timeout: Тайм-аут подпроцесса TLC в секундах (по умолчанию: 60). use_mock: Если true, использует резервный BFS на Python вместо реального TLC.

Параметры
  • csl_contentstringобязательный
  • timeoutinteger
  • use_mockboolean
universe_info

Анализирует пространство состояний («вселенную») политики CSL. Возвращает структурную информацию о пространстве состояний политики: - Все переменные с их областями значений, представлениями в виде множеств TLA+ и мощностями - Общий размер пространства состояний (произведение мощностей всех переменных) - Все ограничения с их условиями и действиями - Анализ покрытия ограничениями (какие переменные ограничены, а какие нет) - Визуализация разбивки пространства состояний Необходим для понимания «вселенной», в которой находится агент, планирования экспериментов Evolving Universe и оценки стоимости верификации TLC перед запуском tla_verify. Аргументы: csl_content: Полный исходный код политики CSL в виде строки.

Параметры
  • csl_contentstringобязательный
venom_agent

Показывает одного агента подробно: его инструменты с параметрами и классами риска, триггеры, статус guard и ключ агента для использования в политиках. Без секретов, без текста промпта. Аргументы: agent_id: идентификатор агента, имя или ключ (из venom_inventory). workspace: папка рабочей области Venom.

Параметры
  • agent_idstringобязательный
  • workspacestring
venom_inventory

Сводка по AI-агентам, которых Venom обнаружил на этой машине: тип, состояние, количество инструментов, самый рискованный класс инструментов, статус защиты, покрытие и главные находки. Скрыто: без значений учётных данных, без текста промптов. Аргументы: workspace: папка рабочей области Venom (по умолчанию: CSL_VENOM_WORKSPACE или папка сервера).

Параметры
  • workspacestring
venom_policy_context

Всё, что нужно, чтобы составить или пересмотреть политику для одного агента: действующая политика (или детерминированный стартовый черновик при первой установке), её находки, дрейф словаря и правила, которым должен следовать корректный черновик. Аргументы: agent_id: идентификатор агента, имя или ключ. workspace: папка рабочей области Venom.

Параметры
  • agent_idstringобязательный
  • workspacestring
venom_propose_exemption

Предлагает вывести агента (scope "agent") или отдельный инструмент (scope "tool") из-под защиты. Всегда сохраняется как предложение; утвердить его в CLI может только оператор. Аргументы: agent: идентификатор агента (или "*" при scope "tool"). scope: "agent" или "tool". reason: почему ему можно доверять. tool: имя инструмента, когда scope равен "tool". workspace: папка рабочего пространства Venom.

Параметры
  • agentstringобязательный
  • reasonstringобязательный
  • scopestringобязательный
  • toolstring
  • workspacestring
venom_save_draft

Проверяет черновик CSL (парсит, валидирует, Z3) и, только если он проходит проверку, сохраняет его в .csl/venom/drafts/ рабочего пространства. Ничего не активирует: оператор просматривает и активирует черновики с помощью cslcore CLI. Аргументы: agent_id: агент, для которого предназначен черновик. csl_content: полный исходный код политики CSL. note: одна строка с пояснением к черновику (сохраняется как комментарий). workspace: папка рабочего пространства Venom.

Параметры
  • agent_idstringобязательный
  • csl_contentstringобязательный
  • notestring
  • workspacestring
verify_policy

Проверяет политику CSL на логическую непротиворечивость с помощью формальной верификации Z3. Выполняет четырёхэтапный анализ: 1. Синтаксическая проверка (парсер) 2. Семантическая проверка (область видимости, типы, белый список функций) 3. Логическая верификация Z3 (достижимость, внутренняя непротиворечивость, попарные конфликты, конфликты на уровне всей политики) 4. Компиляция в IR Возвращает результат верификации с подробными сведениями об ошибках и рекомендациями по их устранению, если обнаружены какие-либо проблемы. Аргументы: csl_content: Полный исходный код политики CSL в виде строки.

Параметры
  • csl_contentstringобязательный

Выберите клиент, чтобы установить Chimera-Protocol/csl-core:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "chimera-protocol-csl-core-62uic5nlql": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "csl-core[mcp]",
        "csl-core-mcp"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "chimera-protocol-csl-core-62uic5nlql": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "csl-core[mcp]",
        "csl-core-mcp"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "chimera-protocol-csl-core-62uic5nlql": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--with",
        "csl-core[mcp]",
        "csl-core-mcp"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"chimera-protocol-csl-core-62uic5nlql\",\"type\":\"stdio\",\"command\":\"uv\",\"args\":[\"run\",\"--with\",\"csl-core[mcp]\",\"csl-core-mcp\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "chimera-protocol-csl-core-62uic5nlql": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "csl-core[mcp]",
        "csl-core-mcp"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add chimera-protocol-csl-core-62uic5nlql -- uv run --with csl-core[mcp] csl-core-mcp

Либо через JSON-конфиг:

claude mcp add-json chimera-protocol-csl-core-62uic5nlql "{\"command\":\"uv\",\"args\":[\"run\",\"--with\",\"csl-core[mcp]\",\"csl-core-mcp\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add chimera-protocol-csl-core-62uic5nlql -- uv run --with csl-core[mcp] csl-core-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.chimera-protocol-csl-core-62uic5nlql]
command = "uv"
args = ["run", "--with", "csl-core[mcp]", "csl-core-mcp"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите Chimera-Protocol/csl-core, а в поле команды запуска — строку ниже:
uv run --with csl-core[mcp] csl-core-mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "chimera-protocol-csl-core-62uic5nlql": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "csl-core[mcp]",
        "csl-core-mcp"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "chimera-protocol-csl-core-62uic5nlql": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "csl-core[mcp]",
        "csl-core-mcp"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например chimera-protocol-csl-core-62uic5nlql.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: chimera-protocol-csl-core-62uic5nlql
    command: uv
    args:
      - "run"
      - "--with"
      - "csl-core[mcp]"
      - "csl-core-mcp"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "chimera-protocol-csl-core-62uic5nlql": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "csl-core[mcp]",
        "csl-core-mcp"
      ]
    }
  }
}

Похожие MCP-сервера

ARKALDA/hejdar-mcp

ARKALDA/hejdar-mcp

от arkalda

MCP-сервер для проверки политик безопасности AI-агентов на лету. Инструмент hejdar_evaluate оценивает действия (READ, WRITE и др.) через Hejdar API. Предотвращает нарушения, подходит для Claude, Ch...

Python⭐ 1
tomjwxf/scopeblind-gateway

tomjwxf/scopeblind-gateway

от tomjwxf

Защитный шлюз для MCP-серверов: логирует вызовы инструментов, применяет per-tool политики (блокировка, лимиты, tier) и опционально выпускает подписанные Ed25519 ресипты для аудита. Полезен разработ...

TypeScript⭐ 11
alberthild/shieldapi-mcp

alberthild/shieldapi-mcp

от alberthild

MCP-сервер для безопасности AI-агентов: детекция промпт-инъекций, сканирование навыков на уязвимости цепочки поставок, проверка URL, паролей, email и IP. Бесплатно 10 вызовов в день без регистрации...

JavaScript⭐ 1
behrensd/mcp-firewall

behrensd/mcp-firewall

от behrensd

mcpwall — прокси-фильтр для MCP: блокирует опасные вызовы, сканирует утечки, аудит. Встаёт между AI-клиентом и сервером, применяет YAML-правила. Защищает от утечек ключей и команд. Полезен для Clau...

TypeScript⭐ 5
panther-labs/mcp-panther

panther-labs/mcp-panther

от panther-labs

Panther MCP сервер предоставляет инструменты для взаимодействия с платформой безопасности Panther: написание детекций, триаж алертов и запросы к логам на естественном языке - прямо из вашей IDE. Ид...

Python⭐ 47
Thezenmonster/agentscore-mcp-server

Thezenmonster/agentscore-mcp-server

от thezenmonster

MCP сервер для оценки безопасности пакетов: сканирует зависимости, выносит вердикты доверия, проверяет уязвимости и настраивает CI-политику. Восемь инструментов без API-ключа. Помогает разработчикам принимать решения о безопасности MCP.

TypeScript⭐ 1
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин