RelayShield MCP Proxy Firewall filtre les appels et résultats d'outils OpenClaw par rapport à l'intelligence sur les menaces avant qu'ils n'atteignent votre agent ou serveur MCP amont.
Installer & Télécharger
1. ClawHub CLI
Le moyen le plus rapide d'installer une compétence directement depuis le registre.
npx clawhub@latest install relayshield-mcp-firewall
2. Installation manuelle
Copiez le dossier de la compétence dans l'un de ces emplacements
~/.openclaw/skills/ <project>/skills/ Priorité : Espace de travail > Local > Intégré
3. Installation du prompt
Copiez ce prompt dans OpenClaw pour l'installer automatiquement.
Aide-moi à installer relayshield-mcp-firewall via Clawhub. Si Clawhub n'est pas installé, installe-le d'abord (npm i -g clawhub).
Vous préférez télécharger ?
Obtenez les fichiers bruts de la compétence dans une archive ZIP.
Qu'est-ce que RelayShield MCP Proxy Firewall ?
RelayShield MCP Proxy Firewall ajoute une couche de sécurité d'exécution entre Openclaw, mcporter et les serveurs MCP amont. Il analyse les définitions d'outils, les arguments d'appel et les résultats renvoyés par rapport à un corpus d'intelligence sur les menaces contenant plus de 700 000 indicateurs.
Le proxy aide à détecter les outils empoisonnés, l'injection de prompt, l'exfiltration d'identifiants, les empreintes de kits de phishing, les URL suspectes et le comportement anormal des outils. Le trafic propre est transféré en amont, tandis que l'activité suspecte peut être bloquée ou mise en quarantaine avec des réponses d'erreur MCP standard et des enregistrements d'audit. En tant que composant d'Openclaw Skills, il offre une protection de pare-feu MCP pratique sans nécessiter de modifications du flux de travail normal des outils de l'agent.
Cas d'utilisation de RelayShield MCP Proxy Firewall
- Protégez les agents OpenClaw contre les définitions d'outils MCP empoisonnés et les outils voisins malveillants.
- Analysez les URL, les domaines et les adresses IP des appels d'outils par rapport à l'intelligence sur les menaces de RelayShield.
- Détectez l'injection de prompt, le détournement d'instructions, l'exposition de secrets, les empreintes de phishing et l'exfiltration d'identifiants dans les résultats des outils.
- Surveillez les séquences d'appels inhabituelles, les pics de volume et les chaînes d'attaques inter-outils grâce à la détection comportementale.
- Gardez les en-têtes d'autorisation amont hors de mcporter et de la configuration de l'agent en les gérant au niveau de la couche proxy.
- Pré-analysez un serveur MCP avant le déploiement pour identifier les fonctionnalités dangereuses et les métadonnées d'outils suspectes.
- Appliquez des règles déclaratives d'autorisation et de refus par agent, tool ou serveur avec un fichier de politique YAML optionnel.
- Fournissez une limite de filtrage locale pour les équipes évaluant Openclaw Skills axé sur la sécurité.
Comment fonctionne RelayShield MCP Proxy Firewall
- Clonez le dépôt RelayShield et installez les dépendances d'exécution requises.
- Exécutez éventuellement le scanner d'outils hors ligne contre le serveur MCP amont pour identifier l'injection de prompt, les schémas d'exfiltration, les paramètres d'identifiants et les fonctionnalités dangereuses avant le déploiement.
- Démarrez une instance de proxy RelayShield pour le serveur MCP amont, en configurant l'URL amont, le port d'écoute, le comportement de filtrage, les niveaux de blocage et l'API key optionnelle.
- Enregistrez l'URL du proxy local dans mcporter au lieu de vous connecter directement au serveur MCP amont.
- OpenClaw envoie le trafic MCP via mcporter au proxy RelayShield, qui extrait et évalue les indicateurs dans les appels d'outils et filtre le contenu renvoyé.
- Le proxy transmet les requêtes et résultats propres en amont, tandis que l'activité suspecte est bloquée ou mise en quarantaine avec des réponses d'erreur MCP standard telles que l'erreur -32001.
- La détection comportementale compare l'activité de l'agent aux bases de référence pour identifier les séquences inhabituelles, les pics de volume et les chaînes d'attaques multi-outils.
- Chaque décision de politique est enregistrée dans les journaux d'audit ; les délais d'attente de filtrage échouent de manière ouverte (fail-open) en autorisant l'appel tout en enregistrant le délai d'attente.
- Utilisez la démo du tableau de bord pour valider que le filtrage est actif et examinez les scores de confiance du verdict et les codes de cause.
Configuration de RelayShield MCP Proxy Firewall
Prérequis
- Python 3.10 ou version récente
- mcporter
- Un dépôt RelayShield cloné
- Une URL de serveur MCP amont
Installez mcporter et clonez RelayShield :
npm install -g mcporter
git clone https://github.com/nzdsf2-gif/relayshield.git
1. Pré-analyser le serveur amont
Exécutez le scanner hors ligne recommandé avant de router le trafic de production :
cd relayshield
python3 -m mcp_proxy.tool_scanner --url https://your-mcp-server.example.com/mcp
Examinez et corrigez les anomalies signalées avant d'activer le proxy d'exécution.
2. Démarrer le proxy RelayShield
cd relayshield
export MCP_PROXY_UPSTREAM="https://your-mcp-server.example.com/mcp"
export MCP_PROXY_PORT="8090"
python3 -m mcp_proxy
Le proxy écoute sur le port 8090. Configurez une instance de proxy par serveur amont, avec un port distinct pour chaque instance.
3. Configurer mcporter
Enregistrez le proxy local plutôt que le point de terminaison amont :
mcporter config add myserver http://127.0.0.1:8090 --scope home
mcporter list myserver
Si l'amont nécessite une autorisation, configurez son en-tête statique dans l'environnement du proxy ou le fichier de politique. mcporter se connecte au proxy local sans authentification amont.
4. Vérifier le filtrage
Exécutez la démonstration interactive sans réseau :
python3 -m mcp_proxy.dashboard --demo
Ouvrez http://127.0.0.1:8091/_rs/dashboard et examinez les scénarios d'attaque, y compris les cas de voisins empoisonnés et de kits de phishing.
Variables de configuration
MCP_PROXY_UPSTREAM: URL du serveur MCP amont requise.MCP_PROXY_PORT: Port du proxy local ; par défaut à8090.MCP_PROXY_SCREENING: Commutateur principal de filtrage de l'intelligence sur les menaces ; par défaut àtrue.MCP_PROXY_BLOCK_LEVELS: Niveaux de verdict qui bloquent ; par défaut àhigh,medium.MCP_PROXY_RESULT_SCREENING: Active le filtrage des résultats ; par défaut àtrue.MCP_PROXY_BEHAVIOR: Active la détection des anomalies comportementales ; par défaut àtrue.RELAYSHIELD_API_KEY: Clé optionnelle pour des vérifications en cache plus approfondies.
Les serveurs MCP Stdio ne peuvent pas être mis en proxy via HTTP. Pour ces serveurs, utilisez le scanner de pré-déploiement et les hooks d'approbation OpenClaw.
Schéma de données et taxonomie de RelayShield MCP Proxy Firewall
Modèle de trafic et de décision
| Zone de données | Ce qui est évalué | Résultat ou action |
|---|---|---|
| Définitions d'outils | Injection de prompt, détournement d'instructions, schémas d'exfiltration, paramètres d'identifiants et fonctionnalités dangereuses | Résultats du scanner de pré-déploiement |
| Appels d'outils | URL, domaines et adresses IP extraits des arguments | Transférer, bloquer ou renvoyer l'erreur MCP -32001 |
| Résultats d'outils | Injection de prompt, matériel secret, empreintes de kits de phishing, PII non masquées et exfiltration d'identifiants vers une infrastructure tierce non-fournisseur d'identité | Résultat filtré, blocage, quarantaine ou événement d'audit |
| Comportement de l'agent | Séquences d'appels, pics de volume et chaînes d'attaques inter-outils | Verdict d'anomalie comportementale |
| Règles de politique | Règles YAML optionnelles d'autorisation et de refus par agent, tool et serveur | Décision déclarative avec journalisation d'audit |
Ressources générées et référencées
- Point de terminaison du proxy : Écouteur HTTP local, généralement
http://127.0.0.1:8090, transmettant auMCP_PROXY_UPSTREAMconfiguré. - Point de terminaison du tableau de bord : Tableau de bord de démonstration local sur
http://127.0.0.1:8091/_rs/dashboard. - Réponses MCP : Les appels suspects peuvent produire des réponses d'erreur MCP standard, y compris le code d'erreur
-32001. - Métadonnées d'intelligence sur les menaces : Les verdicts peuvent inclure des scores de confiance et des codes de cause identifiant les signaux déclenchés.
- Métadonnées d'audit : Les décisions de filtrage et de politique sont enregistrées pour examen.
- Configuration de l'environnement : Le comportement d'exécution est contrôlé via les variables
MCP_PROXY_*et leRELAYSHIELD_API_KEYoptionnel. - Taxonomie des politiques : Des règles YAML optionnelles peuvent cibler un agent individuel, un tool MCP ou un serveur amont.
- Remarque : Le proxy ne certifie pas les résultats comme sûrs ; un résultat non signalé signifie seulement qu'aucun signal configuré n'a été trouvé. Les délais d'attente de filtrage sont enregistrés et échouent de manière ouverte conformément au comportement documenté.
Fonctionnalités avancées de RelayShield MCP Proxy Firewall
- Filtrage de l'intelligence sur les menaces soutenu par un corpus de plus de 700 000 indicateurs.
- Inspection à double couche des appels d'outils et des résultats d'outils plutôt que des appels seuls.
- Détection des anomalies comportementales utilisant des bases de référence d'activité par agent.
- Politiques YAML déclaratives d'autorisation et de refus ciblées sur les agents, les outils et les serveurs.
- Prise en charge optionnelle de RelayShield API key pour des vérifications en cache plus approfondies.
- Scores de confiance et codes de cause pour expliquer les scénarios de démonstration bloqués et les verdicts de filtrage.
- Journalisation d'audit pour les décisions de politique et de filtrage.
- Instances de proxy et ports séparés pour plusieurs serveurs MCP amont.
- Tableau de bord interactif local avec 14 scénarios d'attaque pour valider la chaîne complète OpenClaw vers amont.
- Gestion des délais d'attente en échec ouvert (fail-open) avec journalisation explicite des délais d'attente, permettant aux opérateurs de surveiller les compromis entre disponibilité et sécurité.
- Compatibilité avec les hooks d'approbation OpenClaw pour les serveurs MCP stdio qui ne peuvent pas être mis en proxy via HTTP.
SKILL.md
Chargement
Compétences Openclaw associées
Organisateur de données TikTok
L’Organisateur de données TikTok récupère les données publiques de contenu, de créateurs, d’engagement et de commentaires TikTok au format JSON structuré pour des analyses reproductibles.
Index Query
Transformez des questions en langage naturel sur les indices boursiers en requêtes vérifiées pour obtenir des détails d'indices, des constituants, des valorisations, des performances et des données de marché.
VibePolish
VibePolish ouvre des démos HTML autonomes ou des projets statiques non groupés dans un établi connecté pour l'édition et l'exportation WYSIWYG.
Assistant de commande de courses Meituan
Transformez les courses locales en commande Meituan guidée, avec gestion des adresses, aperçu des frais et confirmation explicite de l’utilisateur avant l’envoi.
Détecteur de contenu IA Qinghu
Vérifiez les passages de texte au style IA et la confiance de génération par l'IA sur les images, puis examinez les résultats avec des contrôles clairs d'incertitude et de coût.
Gestionnaire de Numéros Cloud Fengniao
Un assistant alimenté par Qinghu MCP pour sélectionner, acheter, gérer, renouveler et surveiller les numéros cloud Fengniao et les cartes SIM physiques.
METADATA
En vedette*
