agentseal

AI एजेंटों के लिए सुरक्षा टूलकिट। रेड-टीम प्रॉम्प्ट, MCP पॉइज़निंग का पता लगाएँ,
स्किल फ़ाइलों को स्कैन करें, टॉक्सिक डेटा फ़्लो को ट्रेस करें। 28 एजेंटों पर 225+ टेस्ट।

दस्तावेज़ · MCP रजिस्ट्री · डैशबोर्ड · ब्लॉग

त्वरित आरंभ

pip install agentseal    # या: npm install agentseal
agentseal guard          # अपनी मशीन स्कैन करें - API कुंजी की आवश्यकता नहीं

बस इतना ही। AgentSeal आपकी मशीन पर हर AI एजेंट में खतरनाक स्किल फ़ाइलें, पॉइज़न्ड MCP सर्वर कॉन्फ़िगरेशन और डेटा एक्सफ़िल्ट्रेशन पथ ढूँढ़ता है।

एडवर्सेरियल अटैक के खिलाफ सिस्टम प्रॉम्प्ट का परीक्षण करना चाहते हैं?

agentseal scan --prompt "You are a helpful assistant..." --model ollama/llama3.1:8b  # मुफ्त, लोकल
agentseal scan --prompt "You are a helpful assistant..." --model gpt-4o              # क्लाउड

प्रत्येक कमांड क्या करता है?

* Ollama के साथ मुफ्त। क्लाउड प्रदाताओं (OpenAI, Anthropic, आदि) को API कुंजी चाहिए।

Guard

आपकी मशीन पर सभी AI एजेंट कॉन्फ़िगरेशन को स्कैन करता है। कोई API कुंजी नहीं, कोई नेटवर्क कॉल नहीं - सब कुछ लोकल चलता है।

समर्थित एजेंट: Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Gemini CLI, Codex CLI, Cline, Roo Code, Kilo Code, Copilot CLI, Aider, Continue, Zed, Amp, Amazon Q, Junie, Goose, Kiro, OpenCode, OpenClaw, Crush, Qwen Code, Grok CLI, Visual Studio, Kimi CLI, Trae, MaxClaw.

agentseal guard

Guard मिलने वाली हर फ़ाइल पर छह-चरणीय डिटेक्शन पाइपलाइन चलाता है:

1. पैटर्न सिग्नेचर - ज्ञात दुर्भावनापूर्ण पैटर्न (क्रेडेंशियल एक्सेस, एक्सफ़िल्ट्रेशन URL, शेल कमांड)
2. डीऑबफ़स्केशन - यूनिकोड टैग, Base64, BiDi ओवरराइड, शून्य-चौड़ाई वाले कैरेक्टर, TR39 कन्फ़्यूज़ेबल्स को डिकोड करता है
3. सिमैंटिक विश्लेषण - एम्बेडिंग समानता (MiniLM-L6-v2) पैटर्न को बायपास करने वाले पुनर्लिखित हमलों को पकड़ता है
4. बेसलाइन ट्रैकिंग - SHA-256 हैश आपके पिछले स्कैन के बाद से कॉन्फ़िग बदलावों का पता लगाता है (रग-पुल डिटेक्शन)
5. रजिस्ट्री संवर्धन - MCP सुरक्षा रजिस्ट्री (6,600+ सर्वर) से लाइव ट्रस्ट स्कोर
6. कस्टम नियम - संगठन-विशिष्ट नीतियों को लागू करने के लिए YAML नियम

agentseal guard init             # .agentseal.yaml प्रोजेक्ट नीति उत्पन्न करें
agentseal guard --output sarif   # GitHub Security टैब के लिए SARIF
agentseal guard --output json    # मशीन-पठनीय आउटपुट
agentseal guard --no-diff        # बेसलाइन डेल्टा अनुभाग छोड़ें
agentseal guard test             # अपने कस्टम नियमों को मान्य करें

Scan

एक सिस्टम प्रॉम्प्ट का 225 एडवर्सेरियल अटैक प्रोब के खिलाफ परीक्षण करता है: 82 एक्सट्रैक्शन तकनीक, 143 इंजेक्शन तकनीक, और 8 अनुकूली म्यूटेशन ट्रांसफ़ॉर्म। एक निर्धारक ट्रस्ट स्कोर लौटाता है।

डिटेक्शन कैसे काम करता है: इंजेक्शन प्रोब एक अद्वितीय कैनरी स्ट्रिंग (जैसे SEAL_A1B2C3D4_CONFIRMED) एम्बेड करते हैं। यदि कैनरी प्रतिक्रिया में दिखाई देती है, तो प्रोब लीक हो गया। एक्सट्रैक्शन प्रोब ग्राउंड ट्रुथ प्रॉम्प्ट के खिलाफ n-gram मिलान का उपयोग करते हैं। कोई LLM जज नहीं - एक ही इनपुट, एक ही परिणाम, हर बार।

ट्रस्ट स्कोर (0–100):

# OpenAI
agentseal scan --prompt "You are a helpful assistant..." --model gpt-4o

# Anthropic
agentseal scan --prompt "You are a helpful assistant..." --model claude-sonnet-4-5-20250929

# Ollama (मुफ्त, लोकल)
agentseal scan --prompt "You are a helpful assistant..." --model ollama/llama3.1:8b

# कोई HTTP एंडपॉइंट
agentseal scan --url http://localhost:8080/chat

# एक फ़ाइल से
agentseal scan --file ./prompt.txt --model gpt-4o

CI/CD

agentseal scan --file ./prompt.txt --model gpt-4o --min-score 75

यदि ट्रस्ट स्कोर थ्रेसहोल्ड से कम है तो एक्ज़िट कोड 1। GitHub Security Tab एकीकरण के लिए --output sarif का उपयोग करें।

Scan-MCP

stdio या SSE के माध्यम से एक लाइव MCP सर्वर से जुड़ता है। हर टूल को गिनता है, फिर प्रत्येक विवरण को पैटर्न मिलान, डीऑबफ़स्केशन, सिमैंटिक समानता और वैकल्पिक LLM वर्गीकरण के माध्यम से चलाता है। प्रति सर्वर एक ट्रस्ट स्कोर आउटपुट करता है।

# stdio सर्वर
agentseal scan-mcp --server npx @modelcontextprotocol/server-filesystem /tmp

# SSE सर्वर
agentseal scan-mcp --sse http://localhost:3001/sse

टूल विवरण पॉइज़निंग को पकड़ता है - टूल विवरणों में एम्बेडेड छिपे हुए निर्देश जो एजेंट को डेटा एक्सफ़िल्ट्रेट करने, कमांड निष्पादित करने या उपयोगकर्ता की मंशा को ओवरराइड करने के लिए प्रेरित करते हैं।

Shield

एजेंट कॉन्फ़िग पथों के लिए रीयल-टाइम फ़ाइल वॉचर। जब खतरे दिखाई देते हैं तो डेस्कटॉप सूचनाएँ। पता लगाए गए पेलोड वाली फ़ाइलों को स्वचालित रूप से क्वारंटीन करता है।

pip install agentseal[shield]   # इसमें watchdog + डेस्कटॉप नोटिफिकेशन डिपेंडेंसी शामिल है
agentseal shield

उन्हीं पथों की निगरानी करता है जिन्हें guard स्कैन करता है, लेकिन लगातार। सप्लाई चेन हमलों का पता लगाने के लिए उपयोगी जहाँ npm install या pip install चुपचाप आपके एजेंट कॉन्फ़िग को संशोधित करता है।

यह कैसे काम करता है

graph TD
    U["User"] -->|prompt| A["AI Agent (LLM)"]
    A -->|tool call| M1["MCP Server\n(filesystem)"]
    A -->|tool call| M2["MCP Server\n(slack)"]
    A -->|tool call| M3["MCP Server\n(database)"]

    M1 -->|reads| FS["~/.ssh/\n~/.aws/\n~/Documents/"]
    M2 -->|reads| SL["Messages\nChannels"]
    M3 -->|queries| DB["Tables\nCredentials"]

    SL -.->|"toxic flow"| M1
    M1 -.->|"exfiltration"| EX["Attacker"]

    style U fill:#1a1a2e,stroke:#58a6ff,color:#e6edf3
    style A fill:#1a1a2e,stroke:#58a6ff,color:#e6edf3
    style M1 fill:#3b1d0e,stroke:#f59e0b,color:#e6edf3
    style M2 fill:#3b1d0e,stroke:#f59e0b,color:#e6edf3
    style M3 fill:#3b1d0e,stroke:#f59e0b,color:#e6edf3
    style EX fill:#3b0e0e,stroke:#ef4444,color:#e6edf3
    style FS fill:#1a1a2e,stroke:#30363d,color:#8b949e
    style SL fill:#1a1a2e,stroke:#30363d,color:#8b949e
    style DB fill:#1a1a2e,stroke:#30363d,color:#8b949e

graph LR
    IN["Skill Files\nMCP Configs"] --> P["Pattern\nSignatures"]
    P --> D["Deobfuscation\n(Unicode Tags,\nBase64, BiDi,\nZWC, TR39)"]
    D --> S["Semantic\nAnalysis\n(MiniLM-L6-v2)"]
    S --> B["Baseline\nTracking\n(SHA-256)"]
    B --> R["Registry\nEnrichment"]
    R --> RU["Custom\nRules"]
    RU --> OUT["Report +\nSeverity"]

    style IN fill:#1a1a2e,stroke:#58a6ff,color:#e6edf3
    style P fill:#161b22,stroke:#30363d,color:#e6edf3
    style D fill:#161b22,stroke:#30363d,color:#e6edf3
    style S fill:#161b22,stroke:#30363d,color:#e6edf3
    style B fill:#161b22,stroke:#30363d,color:#e6edf3
    style R fill:#161b22,stroke:#30363d,color:#e6edf3
    style RU fill:#161b22,stroke:#30363d,color:#e6edf3
    style OUT fill:#0d4429,stroke:#22c55e,color:#e6edf3

Python API

from agentseal import AgentValidator

validator = AgentValidator.from_openai(
    client=openai.AsyncOpenAI(),
    model="gpt-4o",
    system_prompt="You are a helpful assistant...",
)
report = await validator.run()
print(f"Trust score: {report.trust_score}/100 ({report.trust_level})")

# Anthropic
validator = AgentValidator.from_anthropic(
    client=client, model="claude-sonnet-4-5-20250929", system_prompt="..."
)

# HTTP endpoint
validator = AgentValidator.from_endpoint(url="http://localhost:8080/chat")

# Custom function - अपना खुद का एजेंट लाएँ
validator = AgentValidator(agent_fn=my_agent, ground_truth_prompt="...")

TypeScript API

npm install agentseal

import { AgentValidator } from "agentseal";
import OpenAI from "openai";

const validator = AgentValidator.fromOpenAI(new OpenAI(), {
  model: "gpt-4o",
  systemPrompt: "You are a helpful assistant...",
});

const report = await validator.run();
console.log(`Score: ${report.trust_score}/100 (${report.trust_level})`);

npm पैकेज समान CLI कमांड (agentseal guard, scan, scan-mcp, shield) और एक प्रोग्रामेटिक TypeScript API प्रदान करता है।

समर्थित प्रदाता

MCP सुरक्षा रजिस्ट्री

6,600+ MCP सर्वर स्कैन किए गए और सुरक्षा जोखिमों के लिए स्कोर किए गए। नाम से खोजें, निष्कर्ष ब्राउज़ करें, इंस्टॉल करने से पहले ट्रस्ट स्कोर जांचें।

agentseal.org/mcp

आवश्यकताएँ

• Python 3.10+ या Node.js 18+
• guard, shield, scan-mcp बिना API कुंजी के ऑफ़लाइन काम करते हैं
• scan के लिए एक LLM आवश्यक है - मुफ्त लोकल इन्फ़रेंस के लिए Ollama का उपयोग करें, या क्लाउड API कुंजी प्रदान करें

Pro

AgentSeal Pro सुरक्षा टीमों के लिए है जो सतत मूल्यांकन चलाते हैं। यह ओपन-सोर्स स्कैनर को इसके साथ विस्तारित करता है:

• MCP टूल पॉइज़निंग प्रोब (+45) - रग-पुल, शैडोइंग, क्रॉस-टूल इंजेक्शन
• RAG पॉइज़निंग प्रोब (+28) - दस्तावेज़ इंजेक्शन, रिट्रीवल मैनिपुलेशन
• मल्टीमॉडल अटैक प्रोब (+13) - इमेज प्रॉम्प्ट इंजेक्शन, ऑडियो जेलब्रेक, स्टेग्नोग्राफ़ी
• व्यवहारिक जीनोम मैपिंग - प्रोफ़ाइल करें कि एक एजेंट अटैक आयामों में कैसे प्रतिक्रिया देता है
• PDF रिपोर्ट और डैशबोर्ड - अनुपालन और हितधारक समीक्षा के लिए निर्यात योग्य रिपोर्ट

AgentSeal क्यों?

*Snyk agent-scan CLI Apache-2.0 है। Evo प्लेटफ़ॉर्म, Agent Guard, और रेड-टीमिंग मालिकाना SaaS हैं।

योगदान

एक डिटेक्शन गैप, एक झूठी सकारात्मकता मिली, या एक नया प्रोब जोड़ना चाहते हैं? सेटअप निर्देशों और PR प्रक्रिया के लिए CONTRIBUTING.md देखें।

• मुद्दे रिपोर्ट करें: github.com/AgentSeal/agentseal/issues
• प्रोब कैटलॉग: PROBES.md - तकनीकों और गंभीरता के साथ सभी 225 अटैक प्रोब की पूरी सूची

लाइसेंस

FSL-1.1-Apache-2.0