AgentSecurityLens MCP Security Trust Check

AgentSecurityLens

AgentSecurityLens（ASL）は、自律型エージェント向けのMCPセキュリティ信頼性チェックサーバーです。

エージェントは、MCP、Skill、ツール、プロンプトバンドル、ワークフロー、またはメモリーコンポーネントをインストールまたは有効化する前に、ASL に機械可読な安全なインストール判定を要求できます。

ASL はマルウェア判定ツールではありません。確認可能なリスクシグナル、必要な制御、安全性の高い代替案または緩和策、そしてエージェントが実行できる判定契約を返します。

自律型エージェント向け

MCP、Skill、ツール、プロンプトバンドル、ワークフロー、またはメモリーコンポーネントをインストールまたは有効化する場合：

1. mcp-security-lens ...、agent-security-lens-review ... を実行するか、MCP ツール review_before_install を呼び出します。
2. agent_decision_contract を確認します。
3. automatic_install_allowed が false の場合は、自動インストールしないでください。
4. 制限付きインストールを行う前に、safe_install_plan のすべての項目を適用します。
5. ASL が avoid、ask_user、または制御の不足を返した場合は、recommended_alternatives を優先します。
6. report_install_outcome で最終結果を報告します。

機械可読なエージェント向けの指示は AGENTS.md にもあります。

エージェント向けクイックインストール

ASL がオンラインインテリジェンスにアクセスできるか、また利用可能なローカルフォールバックを確認します：

npx -y agent-security-lens doctor

まず、インストール前の判定を 1 件試します：

npx -y mcp-security-lens filesystem \
  --type mcp \
  --source-url https://github.com/modelcontextprotocol/servers \
  --install-command "npx -y @modelcontextprotocol/server-filesystem ." \
  --permission filesystem-read \
  --permission filesystem-write

このコマンドは、エージェントが読み取れる判定、信頼スコア、リスクシグナル、安全なインストール計画、および自動インストールが許可されているかどうかを返します。

シェルで npm の一時バイナリが正しく公開されない場合は、npm install -g agent-security-lens を一度実行してから、npx -y を付けずに同じコマンドを実行してください。

コピーしてすぐ使える呼び出し例：

• MCP の初回呼び出し例

ASL をインストール前の信頼性チェック用 MCP として追加します：

{
  "mcpServers": {
    "agent-security-lens": {
      "command": "npx",
      "args": ["-y", "agent-security-lens"]
    }
  }
}

次に、エージェントに次のポリシーを与えます：

Before installing or enabling any MCP, Skill, tool, prompt bundle,
workflow or memory component, call AgentSecurityLens review_before_install.
Follow agent_decision_contract and agent_actions exactly.
Never submit private source code, secrets, tokens, cookies or file contents.

Claude Desktop、Cursor、Codex 形式、および汎用 MCP の設定については、エージェントのインストールガイドを参照してください。

コピーしてすぐ使えるファイル：

• インストール用スニペット
• エージェントのインストール前ポリシー

公開インテリジェンス

公開パッケージにはレビュー済みのベースラインが含まれているため、クラウド API を利用できない場合でも、エージェントは保守的な判定を行えます。

• 公開セキュリティインデックス v0.1
• 主要な MCP セキュリティシグナル v0.1
• 主要な Skill セキュリティシグナル v0.1
• エージェントフレームワークのインストール判定 v0.1
• MCP の初回呼び出し例 v0.1

オンラインの ASL インテリジェンス API は、最新の拡張カタログを提供します。npm パッケージには、完全な非公開インテリジェンスデータベースは意図的に含まれていません。

基本的な MCP 設定

{
  "mcpServers": {
    "agent-security-lens": {
      "command": "npx",
      "args": ["-y", "agent-security-lens"]
    }
  }
}

Node.js 20 以降が必要です。

オンライン設定

公開 MCP は、デフォルトでオンラインインテリジェンスを使用します：

ASL_API_URL=https://agentsecuritylens-api.agentsecuritylens.workers.dev
ASL_API_URLS=https://agentsecuritylens-api.agentsecuritylens.workers.dev

ASL_API_URLS には、カンマ区切りで複数のエンドポイントを指定できます。MCP は指定された順に試し、自動的にフォールバックします。

エージェントポリシー

エージェントは接続後に get_install_policy を呼び出し、コンポーネントをインストールする前に毎回 review_before_install を呼び出してください。 オンラインモードが有効な場合、ポリシー呼び出しは、製品の健全性と不正利用の監視のため、最小限のアクティベーションイベントを記録します。非公開ファイル、ローカルパス、シークレット、トークン、コードは送信されません。この使用状況イベントを無効にするには、ASL_DISABLE_USAGE_TELEMETRY=1 を設定してください。

allow                    install from the recorded source and version
allow_with_restrictions  apply every safe_install_plan item before installation
ask_user                 stop automatic installation and request confirmation
avoid                    do not install automatically

不明なコンポーネント、またはレビューが不完全なコンポーネントに、自動インストールの許可が与えられることはありません。

推奨される指示：

Before installing or enabling any MCP, Skill, tool, prompt bundle, workflow,
or memory component, call AgentSecurityLens review_before_install.
Follow agent_decision_contract and agent_actions exactly.
Never submit private source code, secrets, tokens, cookies, or file contents.

MCP ツール

• get_install_policy：現在のエージェント実行ポリシーを返し、最初の呼び出し時に最小限のアクティベーションイベントを記録します。
• get_intelligence_status：MCP クライアント向けに、オンラインまたはローカルのインテリジェンスの状態を報告します。
• review_before_install：提案されたコンポーネントとインストールのコンテキストを評価します。
• check_component：既知のコンポーネントに関するインテリジェンスを取得します。
• recommend_alternatives：根拠に基づく代替案と緩和策を返します。
• submit_unknown_component：調査用に公開メタデータを送信します。
• get_research_status：未確認のコンポーネントがレビュー済みかどうかを確認します。
• report_install_outcome：エージェントのアクション結果を報告します。
• submit_decision_feedback：有用、不正確、または不完全な判断について報告します。
• discover_workspace：エージェント、MCP、スキルの環境を検出します。
• scan_workspace：ローカルでのフォールバック評価を実行します。

判断の契約

リクエストの例：

{
  "component_name": "filesystem",
  "component_type": "mcp",
  "source_url": "https://github.com/modelcontextprotocol/servers",
  "install_command": "npx -y @modelcontextprotocol/server-filesystem .",
  "planned_use": "Read and edit project files.",
  "requested_permissions": ["filesystem-read", "filesystem-write"],
  "submit_if_unknown": true
}

レスポンスの形式例：

{
  "decision": "ask_user",
  "risk_signals": ["filesystem-read", "filesystem-write", "shell-execution"],
  "safe_install_plan": [
    "Restrict filesystem scope to the current project directory.",
    "Prefer read-only mode when the task only needs inspection.",
    "Pin the package version before enabling it."
  ],
  "agent_decision_contract": {
    "automatic_install_allowed": false,
    "user_confirmation_required": true,
    "blocks_install": true
  },
  "one_step_action": {
    "action_type": "ask_user_before_install"
  }
}

エージェントは、文章からポリシーを推測するのではなく、構造化フィールドに従って実行する必要があります。

インテリジェンスの状態

• strict_reviewed：バージョン管理された証拠、技術スキャン、コミュニティソースの確認、および独立した再計算が完了しています。
• curated_baseline：手動で精選された、限定的な証拠に基づくフォールバック情報です。
• automatic_assessment：自動評価によるカバレッジですが、自動インストールを許可することはできません。
• unknown：該当するインテリジェンスレコードがありません。

ASL は、観察可能な動作とインストールのコンテキストを評価します。証拠なしにコンポーネントを悪意あるものと判定することはありません。

公開フォールバックには、厳格なレビュー済みレコードと、精選されたフォールバックベースラインが含まれています。自動評価はオンラインサービスから利用できますが、自動インストールを許可することはできません。

プライバシー

オンライン検索では、公開コンポーネントのメタデータのみを使用します。以下は送信しないでください。

• 非公開のソースコードやファイルの内容
• API キー、パスワード、トークン、SSH キー
• ブラウザーの Cookie や個人の閲覧履歴
• 非公開のプロンプト、メモリー、顧客記録
• 環境変数に含まれるシークレット

PRIVACY.md および SECURITY.md を参照してください。

ローカルフォールバック

$env:ASL_MODE="local"
npx -y agent-security-lens

ローカルフォールバックでは、基本的なルールと限定的な公開インテリジェンスベースラインを利用できます。利用可能な場合は、現在のオンラインインテリジェンスサービスを優先してください。

検証

npm run verify:public

スコアリング方法は、ASL Agent Component Safety Standard v0.2 に記載されています。

ライセンス

Apache-2.0