📖 読み取り専用ミラー。 argus は正規の AI-Factory モノレポから公開されています。 プルリクエストは受け付けていません — ここにプッシュされたコミットは、次回の同期時に scripts/mirror_satellites.sh によって上書きされます。 🐞 バグを発見した場合やリクエストがある場合は、issue を開いて ください。

ARGUS-3 — MCP サーバー

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

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

MCP ファイアウォールが最優先 — ウォレットは任意。 ARGUS-3 は、サードパーティの MCP サーバーをすべて WARDEN（静的スキャン → 脅威フィード → 発信元 → 定義ピン留め）で検証してから、1 つのツールも実行しません。暗号通貨、ウォレット、オンチェーン経済は デフォルトでオフ です。 (短縮名 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 セキュリティファイアウォール。階層化された静的スキャン、署名付き 脅威フィード、発信元チェック、および rug-pull に対するツール定義のピン留め。 各ゲートは、ARGUS がすでにローカルに保持しているデータのみから判断します。 ウォレットもチェーンも不要で動作します。

2. 💸 ネイティブ決済 (任意) — 暗号通貨を有効にしてウォレットを接続すると、 AIMarket エスクローを通じて Base 上の USDC で呼び出しごとに支払い、受け取ることができます。

…そして、倹約を維持し（ハードな予算ガバナー + ライブトークンメーター — あなたの費用で自己反省はしません）、 あらゆるモデル（Anthropic、OpenAI 互換、中国製、ローカル）に対応し、そして重要なことに — 経済圏が利用できないときは完全に自律的に動作します。 ウォレットなし、AICOM へのネットワークなし? それでも、クラス最高のローカル MCP セキュアアシスタントです。

🔒 暗号通貨はデフォルトで OFF

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

ARGUS が他と違う理由

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

Related MCP server: math-logic-mcp

クイックスタート

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）、すべての説明に Behavior + Usage Guidelines、例付きの構造化パラメータ — スコア評価基準に合わせて調整済み（旧来の 1 行説明ではありません）。

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） · 検証可能な良心（ブロック図） · 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]

• 静的スキャン — ツール定義内のインジェクション / 外部送信 / 秘密情報収集 / 隠しユニコードシグネチャ。ルールは段階的です：ブロッキング ルールは無害な解釈がない表現をカバーし、アドバイザリ ルール（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、販売）を参照してください。

マルチプロバイダー

モデルは 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 がスコアリングされるトラストエッジを公開するデプロイメントはありません。

• Flex カード — 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 をプローブします。エコノミーはコンテナ内ではデフォルトで OFF（自律）です。

開発

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 オープンエージェントエコノミーの一部です。