AgentGuard — security checks for AI agents について
AgentGuardは、AIエージェントが作業中にセキュリティチェックを実行できるオープンソースのMCPサーバーです。テキスト内のシークレットをローカルで検出し、OSV.devでパッケージのバージョンや依存関係マニフェストの既知の脆弱性を確認します。
主な機能
- 01シークレットのローカル検出とマスキング表示
- 02パッケージバージョンのCVE確認
- 03依存関係マニフェストの脆弱性スキャン
- 04stdioとStreamable HTTPに対応
- 05アカウントやAPIキー不要
活用シーン
- 01コミット前にコードや差分のシークレットを確認
- 02パッケージバージョンの既知CVEを確認
- 03プロジェクトのマニフェストから脆弱な依存関係を検出
MCP 対応
AgentGuardは`scan_secrets`、`check_cve`、`scan_dependencies`をMCPツールとして公開します。クライアントはstdioで起動するか、Streamable HTTPエンドポイントに接続できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
docker run -i --rm ghcr.io/shuaicongxiaomai/agentguard:0.1.2ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ghcr.io/shuaicongxiaomai/agentguard:0.1.2stdioツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
AgentGuard — AI エージェント向けセキュリティチェック(MCP サーバー)
無料のオープンソースの単一バイナリ MCP サーバーです。あらゆる AI エージェント(Claude Desktop、Cursor、Claude Code、…)に、処理の流れの中でセキュリティチェックを提供します。
| ツール | 機能 | データソース |
|---|---|---|
scan_secrets | エージェントがテキスト/コード/差分をコミット、ログ記録、送信する前に、ハードコードされたシークレット(API キー、トークン、秘密鍵)を検出します。ローカルで実行され、値はマスクされます。 | ローカル(正規表現+エントロピー) |
check_cve | 特定のパッケージバージョンに既知の CVE があるかどうかを、深刻度と修正版とともに確認します。 | OSV.dev(無料) |
scan_dependencies | go.mod/package.json/requirements.txt をスキャンし、脆弱性のある固定バージョンの依存関係をすべて報告します。 | OSV.dev(無料) |
API キーもアカウントも不要で、テレメトリーもありません。無料の公開 OSV.dev API に問い合わせる CVE 照会を除き、すべてローカルで実行されます。
インストール
セットアップに合った方法を選んでください。どの方法でも同じ stdio MCP サーバーを利用できます。
Docker(Go ツールチェーンは不要)
docker run -i --rm ghcr.io/shuaicongxiaomai/agentguard:latest demo
MCP クライアントの設定(Claude Desktop/Cursor/Claude Code の mcpServers ブロック):
{
"mcpServers": {
"agentguard": {
"command": "docker",
"args": ["run", "-i", "--rm", "ghcr.io/shuaicongxiaomai/agentguard:latest"]
}
}
}
Go のインストール
go install github.com/shuaicongxiaomai/agentguard@latest
{ "mcpServers": { "agentguard": { "command": "agentguard" } } }
ビルド済みバイナリ
Releases
ページからお使いの OS/アーキテクチャ向けのアーカイブをダウンロードして展開し、設定の command にバイナリの絶対パスを指定してください。
ソースからビルド
go build -o agentguard . # append .exe on Windows
実行方法は 3 通り
1. demo — 設定不要で動作を確認:
agentguard demo
サンプル入力に対して 3 つのツールをすべて実行し、結果を出力します。
2. stdio(デフォルト) — ローカルでの使用。MCP クライアントがバイナリを起動します。 ポートは不要で、 クライアントがライフサイクルを管理します。上記の設定を使い、エージェントに次のように尋ねてください: 「これにシークレットが含まれていないかスキャンして」、「lodash 4.17.20 に脆弱性はある?」、 「package.json に脆弱性のある依存関係がないか確認して」。
3. serve — ポートで Streamable HTTP サービスを起動(ホスト型/リモートサーバー向け):
agentguard serve :8080 # or set PORT=8080
# health: GET http://host:8080/healthz
# MCP URL: POST http://host:8080/mcp (clients connect to this URL)
ローカルで使用する場合は stdio を、ユーザーが何もインストールせず URL で接続するホスト型サーバーが必要な場合は serve を使用してください。
注意事項
scan_secretsはローカルで実行され、シークレットの生の値は返さず、マスクされたプレビューのみを返します。scan_dependenciesは 1 回の呼び出しにつき最大 200 件の依存関係を処理し、OSV に並行して問い合わせます。check_cve/scan_dependenciesには OSV.dev へのネットワークアクセスが必要です。scan_secretsは完全にオフラインで動作します。
ライセンス
MIT。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。