Documents de développement Brain-MCP - Outils pour Claude IA plutôt que pour les humains
Un développeur mainteneur du serveur Brain-MCP, qui donne à Claude une mémoire entre les conversations, a découvert que le principal consommateur de leur documentation était Claude plutôt que les lecteurs humains sur GitHub. Ils ont ajouté une section "Pour assistants IA" en haut du README contenant des instructions comportementales plutôt que de simples descriptions d'outils.
Détails clés de l'expérience
Le développeur a créé une page dédiée à brainmcp.dev/for-ai avec des conseils spécifiques pour les assistants IA. Les instructions comportementales dans le README fonctionnent comme un prompt système pour l'utilisation des outils.
La différence immédiate observée a été que Claude a commencé à utiliser les outils plus intelligemment - pas seulement quand on le lui demandait explicitement, mais en injectant proactivement un contexte pertinent lorsque l'utilisateur changeait de sujet.
Modèle de documentation pour la consommation par l'IA
Le développeur suggère que si votre serveur MCP est consommé par une IA, vous devriez écrire une documentation spécifiquement pour l'IA. Cela inclut :
- Pas seulement les noms d'outils et les types de paramètres
- Des conseils réels sur quand et comment utiliser les outils efficacement
- Des instructions comportementales qui influencent la façon dont Claude utilise les outils
Exemples spécifiques de la documentation
La documentation comprend des conseils pratiques tels que :
- Quand effectuer des recherches proactives (par exemple, quand l'utilisateur dit "où en étais-je resté" → appeler tunnel_state)
- Comment présenter les résultats ("synthétisez, ne déversez pas de résultats de recherche bruts")
- Quand NE PAS effectuer de recherches (commandes pures, continuation du même fil de discussion)
Détails techniques
Le serveur Brain-MCP peut être installé avec : pipx install brain-mcp && brain-mcp setup
Le projet comprend 25 outils, est 100% local et est sous licence MIT.
Le développeur demande aux autres développeurs MCP s'ils ont expérimenté des approches similaires pour influencer la façon dont Claude utilise leurs outils au-delà des descriptions d'outils de base.
📖 Read the full source: r/ClaudeAI
👀 See Also
Foreman : Bot Slack Open Source pour le Contrôle à Distance du Code Local Claude
Foreman est un bot Slack gratuit et open source qui fournit un contrôle à distance pour les instances Claude Code exécutées localement. Il permet aux développeurs d'envoyer des tâches à Claude depuis leur téléphone tout en conservant un accès complet au système de fichiers, aux outils et à l'environnement local.
Système ACO : Pipeline multi-agents open source du ticket GitHub à la PR fusionnée
ACO System est un framework open source multi-agent qui exécute automatiquement un pipeline logiciel complet — du problème GitHub à la PR fusionnée — en utilisant six agents IA spécialisés. Il dispose d'une porte Architecte déterministe qui bloque les hallucinations.
Rival-Review : Une boucle d'évaluation croisée pour les plans d'agents IA
Rival-review est un outil sous licence MIT qui utilise un second modèle d'IA pour auditer les plans d'un agent d'IA de codage principal avant leur exécution, détectant des problèmes tels que des plans de retour arrière défectueux, des failles de sécurité et des décisions basées sur des états obsolètes.
Claude crée une application d'analyse immobilière en 3 heures avec des données Zillow en direct via clawhub
Un développeur a utilisé Claude avec l'outil clawhub zillow-full pour construire une application d'analyse de cash-flow locatif — récupérant des données en direct de l'API Zillow, prototypant l'interface autour de réponses JSON réelles, et livrant un prototype fonctionnel en un après-midi.