English Français العربية

AgentGuard — security checks for AI agents

السجل الرسمي الأمن

Secret, CVE and dependency-vulnerability scanning for AI agents (free, OSV.dev).

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

OCI package ghcr.io/shuaicongxiaomai/agentguard:0.1.2
Claude Code 
claude mcp add agentguard-security-checks-for-ai-agents -- docker run -i --rm ghcr.io/shuaicongxiaomai/agentguard:0.1.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "agentguard-security-checks-for-ai-agents": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/shuaicongxiaomai/agentguard:0.1.2"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. AgentGuard — security checks for AI agents (MCP server)
  2. Install
  3. Build from source
  4. Three ways to run it
  5. Notes
  6. License

AgentGuard — security checks for AI agents (MCP server)

A free, open-source, single-binary MCP server that gives any AI agent (Claude Desktop, Cursor, Claude Code, …) security checks in the loop:

ToolWhat it doesData source
scan_secretsFlags hard-coded secrets (API keys, tokens, private keys) in text/code/diffs before the agent commits, logs, or sends them. Runs locally; values are masked.local (regex + entropy)
check_cveWhether a specific package version has known CVEs, with severity + fixed version.OSV.dev (free)
scan_dependenciesScans a go.mod / package.json / requirements.txt and reports every vulnerable pinned dependency.OSV.dev (free)

No API key, no account, no telemetry. Everything runs locally except CVE lookups, which hit the free public OSV.dev API.

Install

Pick whichever fits your setup. All three give the same stdio MCP server.

Docker (no Go toolchain needed)
docker run -i --rm ghcr.io/shuaicongxiaomai/agentguard:latest demo

MCP client config (mcpServers block in Claude Desktop / Cursor / Claude Code):

{
  "mcpServers": {
    "agentguard": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/shuaicongxiaomai/agentguard:latest"]
    }
  }
}
Go install
go install github.com/shuaicongxiaomai/agentguard@latest
{ "mcpServers": { "agentguard": { "command": "agentguard" } } }
Prebuilt binary

Download the archive for your OS/arch from the Releases page, extract it, and point the config command at the absolute path to the binary.

Build from source

go build -o agentguard .          # append .exe on Windows

Three ways to run it

1. demo — see it work, zero config:

agentguard demo

Runs all three tools on sample inputs and prints the results.

2. stdio (default) — local use; the MCP client launches the binary. No port; the client manages its lifecycle. Use any of the configs above, then ask your agent: "scan this for secrets", "is lodash 4.17.20 vulnerable?", "check my package.json for vulnerable deps."

3. serve — Streamable HTTP service on a port (for a hosted/remote server):

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)

Use stdio for local use; use serve when you want a hosted server users connect to by URL without installing anything.

Notes

  • scan_secrets runs locally and never returns raw secret values — only masked previews.
  • scan_dependencies caps at 200 deps per call and queries OSV concurrently.
  • check_cve / scan_dependencies need network access to OSV.dev; scan_secrets is fully offline.

License

MIT.

الأسئلة الشائعة

ما هو AgentGuard — security checks for AI agents؟

Secret, CVE and dependency-vulnerability scanning for AI agents (free, OSV.dev).

كيف أثبّت AgentGuard — security checks for AI agents؟

يعمل على جهازك. في Claude Code: claude mcp add agentguard-security-checks-for-ai-agents -- docker run -i --rm ghcr.io/shuaicongxiaomai/agentguard:0.1.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج AgentGuard — security checks for AI agents إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل AgentGuard — security checks for AI agents مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون AgentGuard — security checks for AI agents؟

ينشره shuaicongxiaomai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.