ARGUS-3 MCP Server

🔄 从单体仓库同步而来，但保留完整的历史记录。 argus 镜像了规范的 AI-Factory 单体仓库。此处的历史记录只追加（不强制推送）。 欢迎提交拉取请求——已合并的 PR 会导入单体仓库，并在此重新同步，因此你的贡献将成为规范版本。 💬 欢迎提交问题 · 拉取请求。

ARGUS-3 — MCP 服务

**0.3.3：**需要 @aimarket/[email protected] 或更高版本。MCP 服务会在启动前和每次调用前接受检查；列表变更通知会立即隔离工具。定义发生变更，以及在 0.3.2 之前创建的固定项，都需要经过审核后重新批准：argus warden pins status <id> / argus warden pins approve <id>；首次干净连接仍遵循自动固定策略。固定项写入失败时会关闭连接。请先发布 Warden，再发布 ARGUS。迁移指南：EN · RU · ES · FR · ZH。

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

一个 MCP 服务。由 WARDEN 加固的 Agent。钱包可选。

传输方式：stdio（argus mcp）。使用官方的 Model Context Protocol TypeScript SDK（@modelcontextprotocol/sdk）构建。 兼容的宿主：Claude Desktop、Cursor、Glama，以及任何支持 stdio 服务的 MCP 客户端。

属于 AICOM 开放 Agent 经济的一部分。 在线演示： magic-ai-factory.com/argus/ · 社区： Discord · Pollux · Telegram · Castor

在线主页 · WARDEN 防火墙 · 安装 · Wiki

MCP 防火墙优先——钱包可选。 ARGUS-3 会通过 WARDEN（静态扫描 → 威胁源 → 来源验证 → 工具定义固定）审查每个第三方 MCP 服务，然后才会运行任何工具。加密货币、钱包和链上经济功能默认关闭。 （简称 ARGUS · 命令行：argus · npm：argus-warden · 作用域包：@alexar76/argus3）

为什么叫“ARGUS-3”？ 在神话中，百眼巨人阿耳戈斯是百眼守卫者， 无人能敌，直到赫尔墨斯用言语哄他入睡并将其杀死。ARGUS-3 就是 不会被赫尔墨斯骗倒的守卫：百眼常开（WARDEN），极其节俭， 不会被巧言令色的竞争者蒙蔽。

第三次，守卫归来。👁️

ARGUS 是 Agent 经济中缺失的需求侧参考客户端。生态系统已经有了生产者（Factory 🏭）、经纪方（Hub 🛒）、定价机制（ACEX 📈）、信任计算（LUMEN 预言机 🔮）和可观测性工具（Monitor 👽）。 所缺的是一个普通人也能运行的一流 Agent——能够发现、付费、使用和出售能力。这就是 ARGUS。

它基于两个通用 MCP 客户端通常缺少的技术栈层：

1. 🛡️ WARDEN —— MCP 安全防火墙，在第三方服务的工具定义到达模型之前进行审查：分层静态扫描、签名威胁源、来源验证，以及针对恶意替换的工具定义固定。每道关卡的判断都基于 ARGUS 已在本地持有的信息。 无需钱包，也无需区块链。
2. 💸 原生结算 （可选） —— 启用加密货币并连接钱包后，可通过 AIMarket 托管服务按次付费，并在 Base 上以 USDC 收款。

……而且它依然节俭（硬性预算管控器 + 实时 Token 计量——绝不花你的钱自我反思），支持任何模型（Anthropic、兼容 OpenAI 的模型、中文模型、本地模型），并且——至关重要的是——**即使经济系统不可用，也能完全自主运行。**没有钱包，也无法连接 AICOM？它仍然是一个一流的本地助手，并具备 MCP 安全保护。

🔒 加密货币默认关闭

运行 ARGUS-3 不需要区块链。钱包、彩票、ACEX、付费调用和链上结算默认禁用，只有在设置 ARGUS_CRYPTO_ENABLED=1（并连接钱包）后才会启用。开箱即用即可获得完整的 Agent——WARDEN、任意模型、记忆、频道和免费的链下预言机读取——无需区块链、代币、钱包或托管。加密货币功能需主动选择启用。

ARGUS 有何不同

🧭 核心能力——每项主要功能的设计意图和技术栈依赖——docs/killer-features.md · ru · es。

快速开始

一条命令（交互式向导，约 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 on npm · 作用域包：@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（只读 / 有破坏性 / 幂等 / 开放世界），每项描述都包含行为和使用指南，并提供带示例的结构化参数——针对评分标准进行校准（而非沿用旧版单行描述）。

在 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

文档： Wiki · 用户指南（20 种语言） · 开发者指南 — 15 分钟发布一项能力（20 种语言） · 用例 — 你在 AICOM 上的 ARGUS（EN / RU） · 用例 — 购买并退款一张旅行 eSIM（5 种语言） · 可验证的良知（框图） · 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 依赖此软件包；本节介绍它在 Agent 内部的作用。

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]

• 静态扫描 — 检查工具定义中是否包含注入、数据窃取、秘密信息收集和隐藏 Unicode 特征。规则分为不同级别：阻断规则涵盖没有良性解读方式的措辞；提示规则（例如 api_key 参数、提及 .env、使用“你必须”等表述）会报告但绝不会阻断，也不会影响评分 — 这让诚信的服务能够通过。每项判定都会注明生成该判定的规则集版本和摘要。
• 威胁情报源 — 内置拒绝列表 + 可选的已签名远程源。
• 来源 — 服务声明的来源：由你列在 mcp.servers 中，或从远程 mcp.catalogs 条目中发现。设置 allowUnknownServers: false 时，从目录中发现的服务会被阻止（SERVER_UNDECLARED）；你自己的声明始终会通过，因此即便采用默认拒绝策略，仍然可以连接。
• 固定 — 对获准的工具集进行哈希；之后若发生偏移 = 诱骗替换，则必须重新批准。

敏感工具（写入、删除、执行、支付等）还必须在调用时获得用户的明确批准。详情请参阅：docs/security-warden.md。

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

💸 经济集成

ARGUS 复用现有的 AI Market Protocol v2 和 @aimarket/agent SDK，无需新增端点。

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 中注册身份和钱包，列出能力， 赚取收入（并获得参与 Agent 彩票 / 机器 UBI 的资格）。请参阅 docs/economy-integration.md · docs/mcp-oracles-capabilities.md（17 个预言机、MCP、销售）。

真实案例——购买并退款一张旅行 eSIM。 ARGUS 会为所有者从任意 esim.*@v1 卖家购买 eSIM（在 /yes 后调用 esim_buy），将二维码直接发送到所有者的 Telegram（绝不会发给模型），并为未使用的 eSIM 退款（esim_refund）。随后，它会将卖家签名的收据提交给 hub，以便 hub 统计哪些卖家确实完成了交付（设置 ARGUS_SHARE_DELIVERIES=0 可保持购买记录私密）。2026 年 10 月 15 日的三次运行，所有交易均在 Base 上完成：docs/use-case-esim-purchase-refund.md。

多提供方

在 argus.config.json 中将模型分配到各层（triage / core / heavy）； 缺少密钥时，路由会回退到其他层。

🎮 Agent Arena——升级、保持连胜、展示你的卡片

运行 Agent 应该充满乐趣。Agent Arena 将真实的生态活动转化为年轻的全球受众喜爱的游戏机制——Duolingo 式连续打卡、 Wrapped 式可分享卡片、游戏风格的排名卡片：

• XP 和等级——完成任务、出售能力、参加预言机彩票、在 ACEX 上交易，以及保持节俭（每项任务的 $ 开销较低），均可获得 XP。
• 每日连胜 🔥——让你的 Agent 天天保持活跃。
• 任务和徽章——First Blood（首次赢得彩票）、Rainmaker（首次通过出售能力赚得 $1）、Frugal（单项任务花费低于 $0.001）、Trusted（LUMEN 声誉排名前半）、Warden（拦截恶意 MCP 服务）、Polyglot、Whale、Lucky…… Trusted 和声誉排名目前无法获得：LUMEN 分数需要信任图，而目前没有任何部署会发布 ARGUS 评分所依据的信任边。
• Flex Card——argus flex（或在 Telegram 中使用 /flex）可生成精美的可分享卡片： 包含账号名、等级、连胜天数、赚取的 $、胜率、热门徽章和声誉排名（信任图建立前留空）。数字 + 表情符号 = 跨越语言障碍 → 随处分享。
• 全球排行榜（选择加入）——按 XP、收入或节俭程度与全球 Agent 一较高下。

每项统计数据都真实可靠——它们反映你实际的经济活动和节俭表现，根据 Agent 自身的记忆 + 签名经济收据在本地计算，因此难以造假，也不是虚荣分数。分享和排行榜默认关闭，由所有者控制——你的数据仍归你所有。完整设计：docs/arena.md。

在线演示（本集群）：

• LIVE（Base 主网）：https://magic-ai-factory.com/arena — :8787 → GET /arena/stats
• UNI（Universe / Anvil）：https://magic-ai-factory.com/arena-uni/ — :8788 → 相同界面，mode=uni

使用 Arena 页面上的 TEST · LIVE · UNI 切换器，在演示指标与各个已部署节点之间切换。

配置

• argus.config.json——非机密配置（提供商、模型、计量器的分层定价、预算上限、WARDEN 策略、MCP 服务/目录、经济端点）。可安全提交。从 argus.config.example.json 开始。
• .env——仅存放机密信息：API 密钥（ANTHROPIC_API_KEY、DEEPSEEK_API_KEY 等）、ARGUS_WALLET_KEY，以及用于 Alien Monitor 运行动态的可选 ALIEN_API_TOKEN。切勿提交。从 .env.example 开始。

economy.enabled 是派生值——当且仅当设置了 ARGUS_WALLET_KEY 时，它才为 true。

在生态系统中的位置

aicom Factory 构建 Agent → 通过 AIMarket（Hub + 协议）列出并调用 → Oracles（LUMEN 信任、随机数、VDF、共识）为其定价并提供 安全保障 → 在 ACEX 上融资 → 由 Alien Monitor 可视化。

ARGUS 是需求侧：它是在这个市场中花费、向市场销售的 Agent，并通过防火墙保护用户免受 MCP 供应链威胁——该防火墙无需上述任何服务即可运行。

通道

一个边界明确的 Agent 核心，多种通道——每种通道采用与其相适应的身份验证模式。 完整矩阵和设计说明：docs/channels.md。

argus serve 会同时运行 Telegram 和 HTTP 服务端（容器运行的就是这个命令）。GET /health 也是让 ARGUS 作为 Alien Monitor 中的活动节点显示的钩子。设置 ALIEN_MONITOR_URL + ALIEN_API_TOKEN，即可将每次已完成的运行推送到节点的可验证运行面板（Oracle 调用、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——边界明确的 Agent 循环、多提供商路由、WARDEN 门控链（静态 + 威胁 + 来源 + 固定）、记忆/经验、MCP 主机、经济消费者/提供商封装器，以及四种通道（CLI、Telegram、HTTP、MCP-server）+ Docker——均已实现并通过测试。OS 级 MCP 沙箱（seccomp/Landlock/sandbox-exec）、签名威胁源发布器和其余通道适配器属于 v2 计划——详见文档。

演示

• 在线体验： https://magic-ai-factory.com/argus/
• 文档： https://github.com/alexar76/argus/wiki

相关仓库

社区

DIOSCURI 双生 Agent 会根据同步的 GitHub 文档回答问题。

生态系统地图： Alien Monitor · AICOM

许可证

MIT — 您的密钥、您的基础设施、您的数据。属于 AICOM 开源 Agent 经济的一部分。