📖 Зеркало только для чтения. argus публикуется из канонического монорепозитория AI-Factory. Pull request'ы не принимаются — любой коммит, отправленный сюда, будет перезаписан scripts/mirror_satellites.sh при следующей синхронизации. 🐞 Нашли ошибку или есть запрос? Пожалуйста, откройте issue.

ARGUS-3 — MCP-сервер

🌐 English · Русский · Español · Français · 中文 · Glossary

Один MCP-сервер. Агент, защищённый WARDEN. Кошелёк — по желанию.

Транспорт: stdio (argus mcp). Создан на официальном TypeScript SDK Model Context Protocol (@modelcontextprotocol/sdk). Совместимые хосты: Claude Desktop, Cursor, Glama и любой MCP-клиент, поддерживающий stdio-серверы.

Часть открытой агентной экономики AICOM. Живое демо: magic-ai-factory.com/argus/ · Сообщество: Discord · Pollux · Telegram · Castor

Сначала межсетевой экран MCP — кошелёк по желанию. ARGUS-3 проверяет каждый сторонний MCP-сервер через WARDEN (статическое сканирование → фид угроз → происхождение → закрепление определений), прежде чем выполнится хоть один инструмент. Криптовалюта, кошелёк и ончейн-экономика отключены по умолчанию. (короткое имя ARGUS · CLI: argus · npm: argus-warden · scoped: @alexar76/argus3)

Почему «ARGUS-3»? В мифе Аргус Панопт — стоглазый страж — был непобедим, пока Гермес не усыпил его речами и не убил. ARGUS-3 — это страж, который не поддаётся Гермесу: сто открытых глаз (WARDEN), предельно экономный, неуязвимый для сладкоречивых конкурентов.

С третьего раза — страж. 👁️

ARGUS — это эталонный клиент со стороны спроса, которого не хватало агентной экономике. В экосистеме уже есть производители (Фабрика 🏭), брокер (Хаб 🛒), ценообразование (ACEX 📈), математика доверия (оракул LUMEN 🔮) и наблюдаемость (Монитор 👽). Не хватало первоклассного агента, которого запускает обычный человек, — агента, который находит, оплачивает, потребляет и продаёт возможности. Это ARGUS.

Он построен на двух уровнях стека, которых обычно нет у типовых MCP-клиентов:

1. 🛡️ WARDEN — межсетевой экран безопасности MCP, который проверяет сторонние серверы до того, как их определения инструментов достигнут модели: многоуровневое статическое сканирование, подписанный фид угроз, проверка происхождения и закрепление определений инструментов против rug-pull'ов. Каждый шлюз принимает решение на основе того, что ARGUS уже хранит локально. Работает без кошелька и без блокчейна.

2. 💸 Нативные расчёты (опционально) — платите за каждый вызов и получайте оплату в USDC на Base через эскроу AIMarket, если включите криптовалюту и подключите кошелёк.

…и он остаётся экономным (жёсткий ограничитель бюджета + живой счётчик токенов — никакой саморефлексии за ваш счёт), работает с любой моделью (Anthropic, OpenAI-совместимые, китайские, локальные) и — что критически важно — полностью автономен, когда экономика недоступна. Нет кошелька, нет сети к AICOM? Это всё равно лучший в своём классе локальный ассистент с защитой MCP.

🔒 Криптовалюта ОТКЛЮЧЕНА по умолчанию

Для запуска ARGUS-3 блокчейн не требуется. Кошелёк, лотерея, ACEX, платные вызовы и ончейн-расчёты отключены по умолчанию и включаются только после установки ARGUS_CRYPTO_ENABLED=1 (плюс кошелёк). Из коробки вы получаете полного агента — WARDEN, любую модель, память, каналы и бесплатные офчейн-чтения оракула — без блокчейна, без токена, без кошелька, без кастодии. Криптовалюта — по желанию.

Чем ARGUS отличается

🧭 Ключевые возможности — проектные намерения и зависимости стека для каждой ключевой функции — docs/killer-features.md · ru · es.

Related MCP server: re-angr

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

Одна команда (интерактивный мастер, ~2 минуты):

curl -fsSL https://magic-ai-factory.com/install | bash

Или установка из npm (тот же CLI, без curl-скрипта):

npm install -g argus-warden@latest
mkdir -p ~/.argus/agent && cd ~/.argus/agent
argus setup && argus doctor

Пакет: argus-warden на npm · scoped: @alexar76/argus3 · CLI: argus · npx argus-warden --help

Затем argus chat или argus serve.

Запуск как MCP-сервер (stdio)

npm install -g @alexar76/argus3
# or: npm install && npm run build && node dist/index.js mcp
argus mcp

Claude Desktop / Cursor (запись mcpServers):

{
  "mcpServers": {
    "argus": {
      "command": "argus",
      "args": ["mcp"]
    }
  }
}

Инструменты (2)

Glama TDQS: MCP annotations (readOnly / destructive / idempotent / openWorld), рекомендации по поведению и использованию в каждом описании, структурированные параметры с примерами — откалибровано по рубрике оценки (а не по старой однострочной).

Публикация на Glama

Листинг: glama.ai/mcp/servers/alexar76/argus

Та же схема, что и aimarket-oracle-gateway: glama.json в корне репозитория + Dockerfile.glama + node dist/index.js mcp.

Если magic-ai-factory.com/install возвращает 404, используйте зеркало: curl -fsSL https://modeldev.modelmarket.dev/install | bash

Документация: Вики · Руководство пользователя (20 языков) · Руководство разработчика — опубликуйте возможность за 15 минут (20 языков) · Пример использования — ваш ARGUS на AICOM (EN / RU) · Проверяемая совесть (блок-схемы) · Когда ARGUS вам не поможет 😈 · Белая книга экосистемы

cd argus
npm install
npm run build

# 1) Configure (safe to commit — NO secrets live here)
cp argus.config.example.json argus.config.json

# 2) Add keys to .env (all optional; with none, ARGUS uses a local Ollama model)
cp .env.example .env      # then edit

# 3) Check what's wired up
node dist/index.js doctor

# 4) Ask something
node dist/index.js ask "summarise https://example.com in three bullets"

# 5) Interactive
node dist/index.js chat

Во время разработки можно пропустить шаг сборки с помощью npm run dev -- ask "…".

Гарантия автономности

ARGUS не нуждается ни в чём от AICOM для работы:

# No ANTHROPIC_API_KEY, no wallet — just a local model:
ARGUS_LOCAL_BASE_URL=http://127.0.0.1:11434/v1 node dist/index.js ask "hello"

Без ARGUS_WALLET_KEY doctor сообщает economy: OFF (autonomous), и весь экономический слой вообще не конструируется. См. docs/autonomy.md.

Архитектура

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

flowchart TB
  subgraph OFF["Runs offline — no AICOM, no wallet"]
    L1["Layer 1 · Providers — Anthropic · OpenAI-compatible · local"]
    L2["Layer 2 · Bounded agent core — plan→execute→observe + budget governor"]
    L3["Layer 3 · Memory / self-learning — episodes · lessons · pins"]
    L4["🛡️ Layer 4 · MCP host + WARDEN — static · threat · origin · pinning"]
    L1 --- L2 --- L3 --- L4
  end
  GATE{{"— autonomy line — needs ARGUS_WALLET_KEY"}}
  L5["🛒 Layer 5 · Economy — discover · pay · invoke · settle · sell"]
  L4 -.-> GATE -.-> L5
  L5 -.->|wraps| SDK["@aimarket/agent SDK"]

Полные диаграммы и карта модулей: docs/architecture.md.

🛡️ WARDEN — межсетевой экран MCP

WARDEN поставляется отдельно как @aimarket/warden — библиотека с нулевыми зависимостями, которую можно поставить перед собственным MCP-хостом, не внедряя ARGUS. ARGUS зависит от этого пакета; этот раздел описывает, что он делает внутри агента.

Описания инструментов MCP-сервера — это текст, управляемый атакующим, который модель читает как инструкции. WARDEN считает каждый сервер враждебным по умолчанию и пропускает каждое подключение через шлюзы, прежде чем любой инструмент станет доступен:

flowchart LR
  S[MCP server] --> A[1 · static scan] --> B[2 · threat feed] --> C[3 · origin] --> D[4 · def-pinning] --> V{allow?}
  V -->|yes| OK[bridge tools<br/>pin defs]
  V -->|no| NO[block + report]

• Статическое сканирование — сигнатуры инъекций / эксфильтрации / сбора секретов / скрытого юникода в определениях инструментов. Правила многоуровневые: блокирующие правила охватывают формулировки без безобидного прочтения; рекомендательные правила (параметр api_key, упоминание .env, «ты должен») сообщаются, но никогда не блокируют и не влияют на оценку — именно это пропускает честные серверы. Каждый вердикт называет версию набора правил + дайджест, которые его сформировали.

• Канал угроз — встроенный список блокировок + опциональная подписанная удалённая лента.

• Происхождение — откуда взялось объявление сервера: вы указали его в mcp.servers, или он был обнаружен из удалённой записи mcp.catalogs. При allowUnknownServers: false сервер, обнаруженный через каталог, блокируется (SERVER_UNDECLARED); ваши собственные объявления всегда проходят, так что режим fail-closed всё равно оставляет способ подключиться.

• Пиннинг — хеширует одобренный набор инструментов; последующий дрейф = rug-pull, требует повторного одобрения.

Чувствительные инструменты (запись/удаление/выполнение/платёж/…) дополнительно требуют явного одобрения пользователя в момент вызова. Подробности: docs/security-warden.md.

node dist/index.js warden scan      # vet your configured MCP servers

💸 Интеграция экономики

ARGUS переиспользует существующий AI Market Protocol v2 и SDK @aimarket/agent — без новых конечных точек.

export ARGUS_WALLET_KEY=0x...                       # enables the economy layer
node dist/index.js economy status
node dist/index.js economy discover "translate to 5 languages" --budget 1
node dist/index.js economy register                 # list ARGUS in the AI Service Mesh

Поток потребителя: discover → openChannel (USDC/Base) → invoke (X-Payment-Channel) → settle. Поток провайдера: зарегистрировать личность + кошелёк в Mesh, перечислить возможности, зарабатывать (и стать кандидатом на лотерею агентов / machine-UBI). См. docs/economy-integration.md · docs/mcp-oracles-capabilities.md (17 оракулов, MCP, продажа).

Мультипровайдерность

Модели назначаются на уровни (triage / core / heavy) в argus.config.json; маршрутизация переключается между уровнями, когда ключ отсутствует.

🎮 Agent Arena — прокачивайтесь, держите серии, показывайте свою карточку

Запуск агента должен быть весёлым. Agent Arena превращает реальную активность экосистемы в игровую механику, которую уже любит молодая глобальная аудитория — серии в стиле Duolingo, карточки для шеринга в стиле Wrapped, геймерские ранговые карточки:

• XP и уровни — зарабатывайте XP за выполнение задач, продажу возможностей, участие в лотерее оракулов, торговлю на ACEX и бережливость (низкий $/задача).

• Ежедневные серии 🔥 — поддерживайте активность агента день за днём.

• Квесты и значки — First Blood (первый выигрыш в лотерее), Rainmaker (первый заработанный $1 за продажу возможностей), Frugal (задача дешевле $0.001), Trusted (верхняя половина репутации LUMEN), Warden (заблокирован вредоносный MCP-сервер), Polyglot, Whale, Lucky… Trusted и репутационный ранг сегодня недоступны: для оценки LUMEN нужен граф доверия, и ни одно развёртывание не публикует рёбра доверия, по которым оценивался бы ARGUS.

• Flex Card — argus flex (или /flex в Telegram) отображает стильную карточку для шеринга: хэндл, уровень, серия, заработанный $, процент побед, лучшие значки, репутационный ранг (пусто, пока не существует графа доверия). Цифры + эмодзи = нет языкового барьера → делитесь где угодно.

• Глобальная таблица лидеров (по желанию) — рейтинг среди агентов по всему миру по XP, заработку или бережливости.

Каждая статистика — реальная — это ваша фактическая экономическая и бережливая производительность, вычисляемая локально из памяти вашего агента + подписанных экономических квитанций, так что её сложно подделать, и это не очки тщеславия. Шеринг и таблица лидеров выключены по умолчанию и контролируются владельцем — ваши данные остаются вашими. Полный дизайн: docs/arena.md.

Живое демо (этот флот):

• LIVE (Base mainnet): https://magic-ai-factory.com/arena — :8787 → GET /arena/stats

• UNI (Universe / Anvil): https://magic-ai-factory.com/arena-uni/ — :8788 → тот же UI, mode=uni

Используйте переключатель TEST · LIVE · UNI на странице Arena, чтобы переключаться между демо-метриками и каждым развёрнутым узлом.

Конфигурация

• argus.config.json — несекретная конфигурация (провайдеры, модели, цены уровней для метра, бюджетные потолки, политика WARDEN, MCP-серверы/каталоги, экономические конечные точки). Безопасно коммитить. Начните с argus.config.example.json.

• .env — только секреты: ключи API (ANTHROPIC_API_KEY, DEEPSEEK_API_KEY, …), ARGUS_WALLET_KEY и опциональный ALIEN_API_TOKEN для ленты запусков Alien Monitor. Никогда не коммитьте. Начните с .env.example.

economy.enabled выводится — он истинен тогда и только тогда, когда задан ARGUS_WALLET_KEY.

Место в экосистеме

Фабрика aicom создаёт агентов → они перечисляются и вызываются через AIMarket (Hub + протокол) → Оракулы (доверие LUMEN, случайность, VDF, консенсус) оценивают и защищают их → финансируются на ACEX → визуализируются Alien Monitor.

ARGUS — сторона спроса: агент, который тратит на этом рынке, продаёт в него и защищает пользователя от цепочки поставок MCP — с межсетевым экраном, которому для работы не нужно ничего из вышеперечисленного.

Каналы

Одно ограниченное ядро агента, много каналов — каждый с естественной для него моделью аутентификации. Полная матрица + дизайн: docs/channels.md.

argus serve запускает Telegram и HTTP-сервер вместе (именно это запускает контейнер). GET /health — также точка подключения, позволяющая ARGUS появляться как живой узел в Alien Monitor. Задайте ALIEN_MONITOR_URL + ALIEN_API_TOKEN, чтобы отправлять каждый завершённый запуск на панель проверяемых запусков узла (вызовы оракулов, блокировки WARDEN, наймы, запечатанные квитанции). Discord, Slack, Email, Matrix, WhatsApp и голос — готовые к добавлению адаптеры (см. документацию).

Развёртывание (Docker)

ARGUS запускает недоверенные MCP-серверы как дочерние процессы, поэтому контейнер также является границей безопасности вокруг них — а не просто упаковкой.

cp argus.config.example.json argus.config.json   # edit
cp .env.example .env                              # add secrets
docker compose up -d --build                      # serve: Telegram + HTTP /health

Секреты берутся из .env (никогда не встраиваются в образ); argus.config.json монтируется только для чтения; состояние сохраняется в томе argus-state; HEALTHCHECK проверяет /health. Экономика по умолчанию ВЫКЛЮЧЕНА в контейнере (автономный режим).

Разработка

npm run typecheck     # tsc --noEmit (strict)
npm test              # vitest (budget governor, MCP host + WARDEN wiring, provider mapping)
npm run build         # emit dist/

Статус

v0.1 — ограниченный цикл агента, мультипровайдерная маршрутизация, цепочка шлюзов WARDEN (статический + угрозы + происхождение + пиннинг), память/уроки, MCP-хост, обёртки потребителя/провайдера экономики и четыре канала (CLI, Telegram, HTTP, MCP-сервер) + Docker — всё реализовано и протестировано. Песочница MCP на уровне ОС (seccomp/Landlock/sandbox-exec), издатель подписанной ленты угроз и остальные адаптеры каналов — трек v2 — см. документацию.

Демо

• Live: https://magic-ai-factory.com/argus/

• Документация: https://github.com/alexar76/argus/wiki

Связанные репозитории

Сообщество

Близнецы DIOSCURI отвечают на вопросы из синхронизированных GitHub-документов.

Карта экосистемы: Alien Monitor · AICOM

Лицензия

MIT — ваши ключи, ваша инфраструктура, ваши данные. Часть AICOM открытой агентной экономики.