Agent Skill Scanner

agent-skill-scanner MCP サーバー

最終更新日：2026-03-31

Claude Code から直接、OpenClaw SKILL.md と Model Context Protocol（MCP）ツール定義ファイルをスキャンして、セキュリティ上の脆弱性を検出します。

プロンプトインジェクション、権限昇格、データ流出、エンコードされたペイロード、組み合わせによるリスクを対象とする22の検出ルールを備えています。エージェントスキルファイル形式を対象とするスキャナーはこれだけです。汎用の静的アプリケーションセキュリティテスト（SAST）ツールでは、これらの形式は一切検出されません。

インストール

Python 3.10+ とスキャナーエンジンが必要です：

pip install agent-skill-scanner

Claude Code で設定する

Claude Code の MCP 設定に追加してください：

{
  "mcpServers": {
    "agent-skill-scanner": {
      "command": "python3",
      "args": ["/path/to/agent-skill-scan-mcp/server.py"]
    }
  }
}

/path/to/ を、このリポジトリをクローンした実際のパスに置き換えてください。

ツール

scan_skill_file

単一のスキルファイルをスキャンして、セキュリティ上の脆弱性を検出します。

scan_skill_file(file_path="/path/to/SKILL.md")

重大度、ルール ID、説明、証拠を含む検出結果を返します。

scan_directory

ディレクトリ内のすべてのエージェントスキルファイルを再帰的に検索してスキャンします。

scan_directory(directory_path="/path/to/skills/")

検出されたすべてのスキルファイルの検出結果を集約して返します。

検出対象

5つのカテゴリにわたる22のルール：

カテゴリ	例
プロンプトインジェクション	システムプロンプトの上書き、ロールの乗っ取り、命令の注入
権限昇格	特権昇格、シェルの起動、永続化メカニズム
データ流出	認証情報へのアクセス、環境変数の読み取り、外部への転送
エンコードされたペイロード	Base64 コマンド、16進数のペイロード、難読化された文字列
組み合わせによるリスク	制限のないツールの連鎖、スキル間のデータフロー、信頼性の侵害

差別化要素

このスキャナーはOpenClaw SKILL.md と MCP ツール定義形式を対象としています。具体的には、汎用 SAST ツール（semgrep、CodeQL）ではまったく検出できない、Markdown に埋め込まれたコードと YAML スキル設定を対象とします。一般的な Python／JavaScript コードをスキャンする場合は、Snyk または semgrep を使用してください。エージェントスキルファイルをスキャンする場合、この形式に対応しているツールはこれだけです。

信頼とセキュリティ

このサーバーは stdio 経由でローカル実行されます。初回の pip install 以外にネットワーク通信はありません。データ収集はありません。テレメトリーもありません。

ソースコードはこのリポジトリで完全に監査できます。スキャナーエンジンのソースコードは github.com/rexcoleman/agent-skill-scanner にあります。

制限事項

• パターンベースの検出のみで、意味解析は行いません
• OpenClaw SKILL.md と MCP ツール定義向けに設計されています
• ルールは公開研究で報告された既知の攻撃パターンを対象としており、ゼロデイは対象外です

リンク

• スキャナー（PyPI）： agent-skill-scanner
• GitHub Action： agent-skill-scan-action
• 研究： rexcoleman.dev

ライセンス

MIT