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
agentcache : Bibliothèque Python pour la mise en cache de préfixes LLM multi-agents
agentcache est une bibliothèque Python qui permet aux frameworks multi-agents LLM de partager des préfixes de prompts mis en cache, atteignant jusqu'à 76 % de taux de succès de cache et réduisant le temps d'inférence de plus de moitié dans les tests avec GPT-4o-mini.
Hors réseau : Utiliser le matériel téléphonique pour des applications d'IA hors ligne
Off Grid est une application open-source qui utilise le matériel de votre téléphone pour des tâches d'IA hors ligne, comme la génération de texte et la transcription vocale.
Deux nouveaux outils open source pour la sécurité et l'optimisation des agents d'IA
Deux outils open source sont disponibles pour les développeurs d'agents IA : AI Agent Defense Kit fournit des compétences de sécurité en temps d'exécution, et AgentGuard (en développement) propose le suivi des coûts, l'analyse de sécurité et la surveillance des activités.
Codesight : Le Moteur de Contexte IA Réduit de 30 000 à 60 000 Tokens les Sessions de Code sur Claude
Codesight est un outil open-source qui analyse les bases de code pour fournir aux agents d'IA de codage un contexte structuré, réduisant ainsi le gaspillage de tokens. Un développeur a collaboré avec le mainteneur pour ajouter l'analyse AST pour Next.js et Prisma, une suite d'évaluation, la télémétrie des tokens et des profils pour Claude Code et Cursor.