Acacian/aegis

Acacian/aegis

от acacian
Agent-Aegis — единый слой управления (governance) для AI-агентов: блокирует prompt-инъекции, маскирует PII, применяет политики и ведет аудит. Работает с 12 фреймворками, включая MCP. Установка `pip install agent-aegis` и одна строка кода включают защиту.

Agent-Aegis

The governance layer for AI agents. One API, 12 frameworks, every governance primitive.

Aegis is to agent governance what Redis is to data structures — one runtime that unifies prompt-injection blocking, PII masking, policy enforcement, trust delegation, and tamper-evident audit across every agent framework. No code changes.
pip install agent-aegis → aegis.auto_instrument() → 12 frameworks are now governed.

OpenSSF Best Practices CI PyPI Python License
Tests Coverage Playground

What is Aegis • Primitives • Frameworks • Use Cases • 30-Second Start • Research • Docs • Playground

English • 한국어


Aegis Demo


What is Aegis

Every AI agent framework reinvents the same governance primitives — and each one does it slightly differently. Aegis is the abstraction layer that unifies them.

Layer What it does Examples
1. Primitives A universal contract for every tool call Action, ActionClaim, Policy, Result, DelegationChain, AuditEvent
2. Adapters Auto-instrument any framework through its own hooks LangChain callbacks, CrewAI BeforeToolCallHook, OpenAI Agents tracing, Google ADK BasePlugin, MCP transport, DSPy modules, httpx middleware, Playwright context
3. Governance Declarative primitives you compose into policy Prompt injection / PII / leak / toxicity guardrails, RBAC, rate limit, cost budget, drift detection, anomaly scoring, trust delegation, justification gap, selection audit, Merkle audit chain
4. Lifecycle One runtime, every stage of agent ops Scan → Instrument → Policy CI/CD → Runtime → Proxy → Audit

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

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

Создаёт новый каталог или проверяет, что каталог существует. Создаёт несколько вложенных каталогов за одну операцию. Если каталог уже существует, операция завершается успешно без сообщений. Подходит для настройки структуры каталогов проектов или проверки существования необходимых путей. Работает только в разрешённых каталогах.

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

Получает рекурсивное древовидное представление файлов и каталогов в виде JSON-структуры. Каждая запись включает 'name', 'type' (file/directory) и 'children' для каталогов. У файлов нет массива children, а у каталогов массив children есть всегда (может быть пустым). Вывод форматируется с отступом в 2 пробела для удобочитаемости. Работает только в разрешённых каталогах.

Параметры
  • excludePatternsstring[]
  • pathstringобязательный
edit_file

Вносит построчные изменения в текстовый файл. Каждое изменение заменяет точные последовательности строк новым содержимым. Возвращает diff в стиле git, показывающий сделанные изменения. Работает только в разрешённых директориях.

Параметры
  • dryRunboolean

    Предпросмотр изменений в формате git-style diff

  • editsobject[]обязательный
  • pathstringобязательный
get_file_info

Получает подробные метаданные о файле или директории. Возвращает полную информацию, включая размер, время создания, время последнего изменения, права доступа и тип. Этот инструмент отлично подходит для понимания характеристик файла без чтения его содержимого. Работает только в разрешённых директориях.

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

Возвращает список каталогов, к которым этому серверу разрешён доступ. Подкаталоги в этих разрешённых каталогах также доступны. Используйте это, чтобы узнать, какие каталоги и их вложенные пути доступны, прежде чем пытаться получить доступ к файлам.

Параметры

Без параметров.

list_directory

Получает подробный список всех файлов и каталогов по указанному пути. Результаты чётко различают файлы и каталоги префиксами [FILE] и [DIR]. Этот инструмент необходим для понимания структуры каталогов и поиска конкретных файлов внутри каталога. Работает только в разрешённых каталогах.

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

Получает подробный список всех файлов и каталогов по указанному пути, включая размеры. Результаты четко различают файлы и каталоги с префиксами [FILE] и [DIR]. Инструмент помогает понять структуру каталогов и найти конкретные файлы внутри каталога. Работает только внутри разрешенных каталогов.

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

    Сортировать элементы по имени или размеру

move_file

Перемещает или переименовывает файлы и каталоги. Может перемещать файлы между каталогами и переименовывать их за одну операцию. Если целевой объект существует, операция завершится ошибкой. Работает в разных каталогах и может использоваться для простого переименования в пределах одного каталога. И исходный, и целевой пути должны находиться в разрешённых каталогах.

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

Читает полное содержимое файла как текст. УСТАРЕЛО: используйте read_text_file.

Параметры
  • headnumber

    Если указано, возвращает только первые N строк файла.

  • pathstringобязательный
  • tailnumber

    Если указано, возвращает только последние N строк файла.

read_media_file

Читает файл и возвращает его в виде блока содержимого, закодированного в base64, с указанием MIME-типа. Изображения и аудиофайлы возвращаются как контент изображения/аудио; любой другой тип файла возвращается как встроенный ресурс. Работает только в разрешённых директориях.

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

Читает содержимое нескольких файлов одновременно. Это эффективнее, чем читать файлы по одному, когда нужно проанализировать или сравнить несколько файлов. Содержимое каждого файла возвращается с его путём в качестыве сслыки. Сбой при чтеении отделъных файлов не останавит всю опрацию. Работает толко в разршённых директориях.

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

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

read_text_file

Читает полное содержимое файла из файловой системы как текст. Обрабатывает различные текстовые кодировки и выдаёт подробные сообщения об ошибках, если файл не удаётся прочитать. Используйте этот инструмент, когда нужно просмотреть содержимое одного файла. Используйте параметр 'head', чтобы прочитать только первые N строк файла, или параметр 'tail', чтобы прочитать только последние N строк файла. Работает с файлом как с текстом независимо от расширения. Действует только в разрешённых каталогах.

Параметры
  • headnumber

    Если указано, возвращает только первые N строк файла.

  • pathstringобязательный
  • tailnumber

    Если указано, возвращает только последние N строк файла.

search_files

Рекурсивно ищет файлы и каталоги, соответствующие шаблону. Шаблоны должны быть в стиле glob и соответствовать путям относительно рабочего каталога. Используйте шаблон вида '.ext' для поиска файлов в текущем каталоге и '**/.ext' для поиска файлов во всех подкаталогах. Возвращает полные пути ко всем подходящим элементам. Отлично подходит для поиска файлов, если вы не знаете их точное местоположение. Ищет только в разрешенных каталогах.

Параметры
  • excludePatternsstring[]
  • pathstringобязательный
  • patternstringобязательный
write_file

Создаёт новый файл или полностью перезаписывает существующий файл новым содержимым. Используйте с осторожностью, так как он перезаписывает существующие файлы без предупреждения. Обрабатывает текстовое содержимое с правильной кодировкой. Работает только в разрешённых директориях.

Параметры
  • contentstringобязательный
  • pathstringобязательный
1.0.0основная
0.9.5
0.9.4
0.9.3
0.9.2
0.9.1
0.7.0
0.6.1
0.6.0
0.5.0
0.4.2
0.4.1
0.4.0
0.3.0
0.2.0
0.1.8
0.1.6
0.1.5
0.1.4
0.1.3

Выберите клиент, чтобы установить Acacian/aegis:

Любой клиент

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

{
  "mcpServers": {
    "acacian-aegis-qsipikzyfo": {
      "command": "uvx",
      "args": [
        "--from",
        "agent-aegis[mcp]",
        "aegis-mcp-proxy",
        "--wrap",
        "npx",
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/home"
      ]
    }
  }
}
CursorCursor

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

{
  "mcpServers": {
    "acacian-aegis-qsipikzyfo": {
      "command": "uvx",
      "args": [
        "--from",
        "agent-aegis[mcp]",
        "aegis-mcp-proxy",
        "--wrap",
        "npx",
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/home"
      ]
    }
  }
}
VS Code

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

{
  "servers": {
    "acacian-aegis-qsipikzyfo": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "agent-aegis[mcp]",
        "aegis-mcp-proxy",
        "--wrap",
        "npx",
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/home"
      ]
    }
  }
}

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

code --add-mcp "{\"name\":\"acacian-aegis-qsipikzyfo\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"--from\",\"agent-aegis[mcp]\",\"aegis-mcp-proxy\",\"--wrap\",\"npx\",\"-y\",\"@modelcontextprotocol/server-filesystem\",\"/home\"]}"
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": {
    "acacian-aegis-qsipikzyfo": {
      "command": "uvx",
      "args": [
        "--from",
        "agent-aegis[mcp]",
        "aegis-mcp-proxy",
        "--wrap",
        "npx",
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/home"
      ]
    }
  }
}
Claude CodeClaude Code

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

claude mcp add acacian-aegis-qsipikzyfo -- uvx --from agent-aegis[mcp] aegis-mcp-proxy --wrap npx -y @modelcontextprotocol/server-filesystem /home

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

claude mcp add-json acacian-aegis-qsipikzyfo "{\"command\":\"uvx\",\"args\":[\"--from\",\"agent-aegis[mcp]\",\"aegis-mcp-proxy\",\"--wrap\",\"npx\",\"-y\",\"@modelcontextprotocol/server-filesystem\",\"/home\"]}"
CodexCodex

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

codex mcp add acacian-aegis-qsipikzyfo -- uvx --from agent-aegis[mcp] aegis-mcp-proxy --wrap npx -y @modelcontextprotocol/server-filesystem /home

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

[mcp_servers.acacian-aegis-qsipikzyfo]
command = "uvx"
args = ["--from", "agent-aegis[mcp]", "aegis-mcp-proxy", "--wrap", "npx", "-y", "@modelcontextprotocol/server-filesystem", "/home"]
PerplexityPerplexity

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

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите Acacian/aegis, а в поле команды запуска — строку ниже:
uvx --from agent-aegis[mcp] aegis-mcp-proxy --wrap npx -y @modelcontextprotocol/server-filesystem /home

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

WindsurfWindsurf

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

{
  "mcpServers": {
    "acacian-aegis-qsipikzyfo": {
      "command": "uvx",
      "args": [
        "--from",
        "agent-aegis[mcp]",
        "aegis-mcp-proxy",
        "--wrap",
        "npx",
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/home"
      ]
    }
  }
}
ClineCline

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

{
  "mcpServers": {
    "acacian-aegis-qsipikzyfo": {
      "command": "uvx",
      "args": [
        "--from",
        "agent-aegis[mcp]",
        "aegis-mcp-proxy",
        "--wrap",
        "npx",
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/home"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например acacian-aegis-qsipikzyfo.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: acacian-aegis-qsipikzyfo
    command: uvx
    args:
      - "--from"
      - "agent-aegis[mcp]"
      - "aegis-mcp-proxy"
      - "--wrap"
      - "npx"
      - "-y"
      - "@modelcontextprotocol/server-filesystem"
      - "/home"
Zed

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

{
  "context_servers": {
    "acacian-aegis-qsipikzyfo": {
      "command": "uvx",
      "args": [
        "--from",
        "agent-aegis[mcp]",
        "aegis-mcp-proxy",
        "--wrap",
        "npx",
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/home"
      ]
    }
  }
}

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

ppcvote/misp-mcp-server

ppcvote/misp-mcp-server

от ppcvote

MCP сервер для безопасного доступа LLM-агентов к платформе MISP. С защитой от prompt-инъекций и read-only. 8 инструментов для поиска событий, атрибутов и тегов. Для аналитиков ИБ и threat intel команд.

TypeScript⭐ 2
GUCCI-atlasv/skillssafe-mcp

GUCCI-atlasv/skillssafe-mcp

от gucci-atlasv

MCP сервер SkillsSafe сканирует SKILL.md и конфиги на угрозы: кражу данных, prompt-инъекции, shell-инъекции. Бесплатный инструмент без регистрации для защиты AI-агентов. Полезен разработчикам, рабо...

JavaScript⭐ 1
ikoskela/wisepanel-mcp

ikoskela/wisepanel-mcp

от ikoskela

MCP сервер для запуска мульти-агентных дебатов через Wisepanel. Собирайте панели из Claude, Gemini и Perplexity, получайте ответы в реальном времени и публикуйте результаты. Идеально для разработчиков и исследователей, желающих сравнить поведение разных моделей на одном вопросе.

TypeScript⭐ 3
agntor/mcp

agntor/mcp

от agntor

MCP сервер для проверки доверия и сертификации AI агентов. Помогает разработчикам проверять подлинность агентов, защищать от инъекций и управлять escrow-платежами.

TypeScript⭐ 1
unixlamadev-spec/aiprox-mcp

unixlamadev-spec/aiprox-mcp

от unixlamadev-spec

MCP-сервер для реестра AI-агентов AIProx: находите, нанимайте и оплачивайте агентов по задачам через Bitcoin Lightning, Solana USDC и Base x402. Полезен разработчикам, создающим автономные агентски...

JavaScript⭐ 1
sidclawhq/platform

sidclawhq/platform

от sidclawhq

SidClaw — MCP-сервер для контроля действий AI-агентов. Перехватывает вызовы, оценивает по правилам, блокирует опасные или отправляет на утверждение. Интегрируется с 18+ фреймворками: Claude, LangChain, OpenAI. Применяется в DevOps, финансах и здравоохранении.

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

Лука Никитин