ARGUS-3 MCP Server

🔄 モノレポと同期 — ただし履歴は継続します。 argus は正規の AI-Factory モノレポをミラーしています。こちらの履歴は追記専用です（強制プッシュは行いません）。 プルリクエストを歓迎します — マージされた PR はモノレポに取り込まれ、こちらにも再同期されるため、皆さんの貢献が正式なものになります。 💬 Issue · プルリクエスト のどちらも歓迎します。

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 · 中文 · 用語集

1つの MCP サーバー。WARDEN で強化されたエージェント。ウォレットは任意。

トランスポート：stdio（argus mcp）。公式の Model Context Protocol TypeScript SDK（@modelcontextprotocol/sdk）で構築されています。 対応ホスト：Claude Desktop、Cursor、Glama、および stdio サーバーに対応するすべての MCP クライアント。

AICOM オープンエージェントエコノミーの一部です。 ライブデモ： magic-ai-factory.com/argus/ · コミュニティ： Discord · Pollux · Telegram · Castor

ライブ版ランディングページ · WARDEN ファイアウォール · インストール · Wiki

まずは MCP ファイアウォール — ウォレットは任意です。 ARGUS-3 は、ツールが一つでも実行される前に、WARDEN を通じてすべてのサードパーティ製 MCP サーバーを審査します（静的スキャン → 脅威フィード → オリジン確認 → ツール定義の固定）。暗号資産、ウォレット、オンチェーン経済はデフォルトでオフです。 (短縮名 ARGUS · CLI：argus · npm：argus-warden · スコープ付き：@alexar76/argus3)

なぜ「ARGUS-3」なのか？ 神話に登場する百眼の巨人アルゴスは、ヘルメスに話術で眠らされ、殺されるまで無敵でした。ARGUS-3 はヘルメスの口車に乗らない見張り役です。百の目を見開き（WARDEN）、極めて倹約的で、口のうまい競合相手にも動じません。

三度目こそ、見張り役の出番です。👁️

ARGUS は、エージェント経済に欠けていた需要側のリファレンスクライアントです。エコシステムにはすでに、生産者（Factory 🏭）、ブローカー（Hub 🛒）、価格設定（ACEX 📈）、信頼性の計算（LUMEN オラクル 🔮）、可観測性（Monitor 👽）があります。しかし欠けていたのは、誰もが実行できる一級のエージェント、つまり機能を発見し、料金を支払い、利用し、販売するエージェントでした。それが ARGUS です。

汎用 MCP クライアントには通常ない、2 つのスタックレイヤーを基盤に構築されています。

1. 🛡️ WARDEN — ツール定義がモデルに届く前にサードパーティ製サーバーを審査する MCP セキュリティファイアウォールです。段階的な静的スキャン、署名済み脅威フィード、オリジン確認、そしてラグプルを防ぐツール定義の固定を備えています。各ゲートは ARGUS がすでにローカルに保持している情報に基づいて判定します。 ウォレットもブロックチェーンも不要です。
2. 💸 ネイティブ決済 (任意) — 暗号資産を有効にしてウォレットを接続すると、AIMarket のエスクローを通じて Base 上で呼び出しごとに支払い、USDC で報酬を受け取れます。

…さらに、倹約的な設計（厳格な予算管理機能とリアルタイムのトークンメーターを備え、利用者の負担で自己反省することはありません）で、あらゆるモデル（Anthropic、OpenAI 互換、中国語対応、ローカル）を利用でき、そして何より、経済圏が利用できないときも完全自律で動作します。 ウォレットなし、AICOM へのネットワーク接続なしでも、一流のローカル MCP セキュアアシスタントとして使えます。

🔒 暗号資産機能はデフォルトでオフです

ARGUS-3 の実行にブロックチェーンは必要ありません。 ウォレット、宝くじ、ACEX、有料呼び出し、オンチェーン決済はデフォルトで無効で、ARGUS_CRYPTO_ENABLED=1（およびウォレット）を設定した場合にのみ有効になります。初期状態で利用できるのは、WARDEN、あらゆるモデル、メモリ、チャネル、無料のオフチェーンオラクル読み取りを備えた完全なエージェントです。ブロックチェーン、トークン、ウォレット、カストディは不要です。暗号資産機能は任意で有効にできます。

ARGUSが異なる理由

🧭 主な機能 — 主要機能それぞれの設計意図とスタックの依存関係 — docs/killer-features.md · ru · es。

クイックスタート

コマンドを1つ実行（対話型ウィザード、約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（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

ドキュメント： 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をご覧ください。

アーキテクチャ

5 つのレイヤーで構成されています。自律性ラインより上のすべてはオフラインで動作し、ウォレットの存在のみを条件に、経済レイヤーが下から組み込まれます。

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 として別途提供されています。ARGUS を導入せずに、独自の MCP ホストの前段に配置できる、依存関係ゼロのライブラリです。 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]

• 静的スキャン — ツール定義に含まれるインジェクション／情報流出／シークレット窃取／隠し 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 に ID とウォレットを登録し、機能を掲載して、 収益を得ます（エージェントの抽選／マシン UBI の対象にもなります）。詳しくは docs/economy-integration.md · docs/mcp-oracles-capabilities.md（17 件のオラクル、MCP、販売）をご覧ください。

実例 — 旅行用 eSIM の購入と返金。 ARGUS は所有者のために、任意の esim.*@v1 販売者から eSIM を購入し（/yes の後に esim_buy）、QR コードをモデルに見せることなく、所有者の Telegram に直接送信します。また、未使用の eSIM の返金を受けます（esim_refund）。その後、販売者の署名付き領収書をハブに送信し、実際に商品を提供している販売者をハブが集計できるようにします（ARGUS_SHARE_DELIVERIES=0 にすると購入内容は非公開になります）。2026 年 10 月 15 日に実行した 3 回の購入。すべての取引は Base 上で行われました：docs/use-case-esim-purchase-refund.md。

マルチプロバイダー

モデルは argus.config.json で各層（triage / core / heavy）に割り当てられます。 キーが不足している場合、ルーティングは別の層にフォールバックします。

🎮 Agent Arena — レベルアップして、連続記録を保ち、自分のカードを見せよう

エージェントの実行は楽しいものであるべきです。Agent Arena は、実際のエコシステム活動を、 若くグローバルなユーザー層におなじみのゲーム要素に変換します。Duolingo 風の連続記録、 Wrapped 風の共有可能なカード、ゲームのランクカードなどを利用できます。

• XP とレベル — タスクの完了、機能の販売、オラクル抽選への参加、ACEX での取引、 倹約（タスクあたりの $ が少ないこと）で XP を獲得します。
• デイリーストリーク 🔥 — エージェントを毎日続けて稼働させましょう。
• クエストとバッジ — First Blood（初めての抽選当選）、Rainmaker（機能の販売で初めて $1 を獲得）、 Frugal（$0.001 未満でタスクを完了）、Trusted（LUMEN 評判が上位半分）、 Warden（悪意のある MCP サーバーをブロック）、Polyglot、Whale、Lucky… Trusted と評判ランクは、現在は獲得できません。LUMEN スコアには信頼グラフが必要ですが、 ARGUS のスコア算出に使われる信頼エッジを公開しているデプロイはありません。
• フレックスカード — argus flex（または Telegram で /flex）を実行すると、ハンドル、 レベル、連続記録、獲得した $、勝率、上位バッジ、評判ランク（信頼グラフができるまでは空欄）を記載した、 洗練された共有可能なカードが生成されます。数字と絵文字なら言語の壁がないため、どこでも共有できます。
• グローバルリーダーボード (オプトイン) — XP、収益、倹約度で世界中のエージェントと順位を競えます。

すべての統計は実際のものです。エージェント自身のメモリと署名付き経済領収書からローカルで算出される、 実際の経済活動と倹約の実績なので、偽造は困難で、見せかけのポイントではありません。共有とリーダーボードは デフォルトでオフで、所有者が管理します。データは所有者のものです。設計の詳細：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 → 同じ UI、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 がエージェントを構築し、AIMarket（Hub ＋ プロトコル）経由で一覧表示・呼び出しを行い、Oracles（LUMEN の信頼性、乱数、 VDF、コンセンサス）がエージェントの価格設定と保護を担い、ACEX で 資金調達し、Alien Monitor で可視化します。

ARGUS は需要側です。この市場で支出し、市場に参入して販売し、 MCP サプライチェーンからユーザーを守るエージェントです。そのためのファイアウォールは、 上記のいずれもなくても機能します。

チャネル

境界の定められた 1 つのエージェントコアに、複数のチャネルを用意しています。それぞれに適した認証方式を採用しています。 全体の一覧と設計については、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 ホスト、エコノミーの消費者／プロバイダー用ラッパー、4 つのチャネル（CLI、Telegram、HTTP、MCP サーバー）＋ Docker を実装し、テスト済みです。OS レベルの MCP サンドボックス化（seccomp/Landlock/sandbox-exec）、署名付き脅威フィードのパブリッシャー、残りのチャネルアダプターは v2 で対応予定です。ドキュメントをご覧ください。

デモ

• ライブデモ： https://magic-ai-factory.com/argus/
• ドキュメント： https://github.com/alexar76/argus/wiki

関連リポジトリ

コミュニティ

DIOSCURI の双子エージェントが、同期された GitHub ドキュメントをもとに質問に回答します。

エコシステムマップ： Alien Monitor · AICOM

ライセンス

MIT — キーも、インフラも、データもあなたのものです。AICOM のオープンなエージェントエコノミーの一部です。