Applique une politique de code de conduite sur l'ensemble des connecteurs MCP, en refusant les combinaisons d'outils interdites avant l'exécution de l'appel en amont.
Aussi connu sous Aggrete/aggrete
- Étoiles
- 2
- Outils
- —
- Téléchargements, 30 jours
- 454
- Dernière version
- 0.8.3
- Dernier commit
- 15 oct. 2026
- Licence
- Apache-2.0
Qu'est-ce que Aggrete MCP ?
Applique une politique de code de conduite sur l'ensemble des connecteurs MCP, en refusant les combinaisons d'outils interdites avant l'exécution de l'appel en amont.
Résumé généré à partir du README du projet
À propos du MCP server Aggrete
Aggrete permet aux organisations utilisant plusieurs connecteurs MCP de prévenir les fuites de données sensibles en surveillant les combinaisons d'outils. Il agit comme une couche proxy qui évalue si une séquence d'appels d'outils viole une politique de code de conduite prédéfinie. Contrairement à l'autorisation standard qui examine les requêtes individuelles, ce système utilise une mémoire par utilisateur pour suivre les informations collectées tout au long d'une session, afin d'empêcher l'agrégation de données interdites avant même que l'appel en amont ne soit effectué.
Les développeurs peuvent le déployer via pip ou uvx et le configurer à l'aide d'un fichier de politique YAML. Le serveur fournit des outils spécialisés comme check pour tester des plans à blanc et scan pour identifier les chemins de fuite ou les instructions cachées dans les descriptions d'outils. Il gère les identifiants en amont pour prévenir les attaques de type confused-deputy et peut masquer des informations sensibles comme les numéros de sécurité sociale ou les e-mails dans les résultats. Pour les environnements de haute sécurité, il permet de mettre les appels en pause pour une approbation humaine via Slack ou le terminal, et fournit un audit infalsifiable via des lignes JSON chaînées par hachage.
Ce que vous pouvez faire avec
- 1Prévention de l'agrégation de données sensiblesUn client IA tente de combiner des données RH, financières et opérationnelles pour identifier des employés spécifiques dans le cadre d'une liste de licenciement.
- 2Renforcement de l'infrastructure MCP existanteUn développeur doit identifier les combinaisons d'outils qui créent des chemins de fuite ou découvrir des secrets cachés dans les configurations client.
- 3Validation de séquences d'appels d'outilsUn utilisateur souhaite prévisualiser si une séquence spécifique d'appels d'outils prévus sera autorisée par la politique actuelle.
- 4Application de workflows avec intervention humaineUn système met en pause un appel d'outil automatisé jusqu'à ce qu'un responsable de la politique fournisse une approbation auditée.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Aggrete MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Aggrete MCP dans Claude Code
$ claude mcp add aggrete -- uvx aggreteInstaller Aggrete MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"aggrete": {
"command": "uvx",
"args": [
"aggrete"
]
}
}
}Installer Aggrete MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"aggrete": {
"type": "stdio",
"command": "uvx",
"args": [
"aggrete"
]
}
}
}Installer Aggrete MCP dans VS Code CLI
$ code --add-mcp '{"name":"aggrete","type":"stdio","command":"uvx","args":["aggrete"]}'Installer Aggrete MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"aggrete": {
"command": "uvx",
"args": [
"aggrete"
]
}
}
}Installer Aggrete MCP dans Codex
$ codex mcp add aggrete -- uvx aggreteInstaller Aggrete MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.aggrete] command = "uvx" args = ["aggrete"]
Installer Aggrete MCP dans Gemini CLI
$ gemini mcp add -s user aggrete uvx -- aggreteInstaller Aggrete MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"aggrete": {
"command": "uvx",
"args": [
"aggrete"
]
}
}
}Vérifications automatisées
Exécuté le 12 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibleRéussi
- Licence open source (OSI)Réussi
- Commit ou version publiée au cours de l'année écouléeRéussi
- Nom du package non proche d'un package populaireRéussi
- L'endpoint distant utilise HTTPSNon vérifié
- Les outils destructifs sont étiquetésNon vérifié
- Aucune instruction cachée destinée au modèleRéussi
- Aucun avis critique dans le package ou ses dépendancesRéussi
README
Voir sur GitHubAggrete
An MCP proxy that enforces a code-of-conduct document across connectors, with per-user memory that accumulates across calls.
Four individually-authorized questions can assemble a layoff list — no single one is sensitive, so no guardrail fires. Aggrete is the layer that catches the combination: is this call, together with everything this person already pulled today, something the code of conduct forbids?
Try it live — nothing to install · or uvx aggrete --demo
Start with a scan
pip install aggrete && aggrete scan
Finds every MCP server your clients use, connects to each, and prints what no per-server scanner does: tool combinations across servers that form a leak path, hidden instructions in descriptions, secrets in client configs, servers that bypass the proxy. --fix writes the config and policy that close them. Details.
Install
pip install aggrete # or: uv tool install aggrete
uvx aggrete --demo # the walkthrough — no config, auth, or network
aggrete --config proxy.config.yaml # run it for real
The one example
The check tool dry-runs a plan and returns the verdict before anything is fetched:
Plan check: REFUSED.
1. hr__recent_joiners [hr-personnel] -> allowed
2. finance__budget_roles [finance-comp] -> allowed
3. ops__oncall_draft [ops-rota] -> REFUSED COC-HR-004
Personnel, compensation, and operational rosters may not be combined to
derive the planned departure of identifiable individuals.
Each call is fine alone. The third completes a forbidden set across three domains that overlap on the same people, so it's denied before the upstream call — the data is never fetched.
What it does
- Refuses before fetching, using a YAML policy and per-user memory across calls and sessions — not single-call authorization.
- Redacts emails, SSNs, cards, and tokens from results before they reach the model; hides walled tools from users who can't call them.
- Shields against prompt injection — any write after a session reads untrusted content is refused — and against tool poisoning, flagging hidden instructions in tool descriptions.
- Holds upstream credentials itself (confused-deputy safe), with optional per-user on-behalf-of access.
- Audits tamper-evidently — every decision is one hash-chained JSON line (
aggrete-audit), forwarded to a SIEM or an OpenTelemetry collector, with Prometheus metrics and health endpoints for operations. - Ask before you act —
checkpreviews any sequence,scenarioslists things to try. - Hold for a human —
action: approvepauses a call until the clause owner approves it, from Slack, the terminal, or the console; the approval is a time-limited, audited grant.
Learn more
- Writing policy — the
coc.yamlschema, rule types,arg_match, and drafting from your handbook withaggrete-ingest - Deploying — architecture, the deploy matrix, HTTP + OAuth, connecting Claude, and per-user credentials
- Building a connector — expose read/write tools and govern any system (Google Drive is the reference)
- Adapter mode — run the engine inside agentgateway (native ExtMCP over gRPC,
aggrete extmcp), Docker MCP Gateway, IBM ContextForge or any AuthZEN-speaking gateway - What it does not stop — supply chain, host execution, client bugs, memory poisoning: where a proxy is the wrong control and what is
- Scanning —
aggrete scanhardens an existing MCP setup: cross-server leak paths, poisoned descriptions, secrets in configs, proxy bypasses, and a one-command fix - Conformance —
aggrete conformanceruns sixteen checks against the real components and maps them onto the OWASP MCP Top 10, OWASP Agentic Top 10, CoSAI and AIUC-1;--urlruns the same scenarios black-box against any gateway (latest report) - Roadmap — shipped, in progress, and planned
- Agent skill — teach Claude Code or any MCP client to set up and operate Aggrete:
/plugin marketplace add aggrete/aggrete, or readskill://aggrete/SKILL.mdfrom a running proxy
Honest limitations
- Post-call denial redacts, it does not un-fetch — prefer rules decidable pre-call.
- stdio identity is advisory — real enforcement needs streamable HTTP with OAuth and IdP-level blocking of direct connector grants, so the proxy is the only path.
- Aggregation can only be narrowed, not solved — a user who spaces requests beyond the window, or paraphrases across systems the proxy doesn't front, gets through. This raises the cost and creates the audit trail; it isn't a ceiling.
- Not a gateway — no multi-tenancy, token vault, or HA. For production, run it behind agentgateway, Docker's gateway or IBM ContextForge and let them call it (adapter mode).
mcp-name: io.github.aggrete/aggrete
Questions sur Aggrete MCP
Comment ajouter Aggrete MCP à Claude Code ?
Exécutez claude mcp add aggrete -- uvx aggrete dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Aggrete MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Que fait Aggrete pour les clients MCP ?
Il agit comme un proxy qui vérifie chaque appel d'outil par rapport à une politique de code de conduite et à la mémoire par utilisateur, refusant les appels interdits avant que les données ne soient récupérées.
Comment effectuer un test à blanc (dry-run) d'un plan d'appels d'outils ?
Utilisez l'outil check, qui renvoie un verdict allowed ou REFUSED pour une séquence d'appels avant toute récupération de données.
Aggrete peut-il détecter des problèmes dans ma configuration MCP actuelle ?
Oui, lancez aggrete scan pour identifier les chemins de fuite entre serveurs, les instructions cachées dans les descriptions, les secrets dans les configurations client et les contournements de proxy.
Aggrete masque-t-il les données sensibles dans les résultats ?
Il masque les e-mails, les numéros de sécurité sociale, les cartes bancaires et les tokens des résultats d'outils avant qu'ils n'atteignent le modèle.
Comment les décisions sont-elles auditées ?
Chaque décision est enregistrée sous la forme d'une ligne d'audit JSON chaînée par hachage et peut être transmise à un SIEM ou un collecteur OpenTelemetry.