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
Superglue CLI : Laissez les agents IA exécuter des appels API sans outils pré-construits
Superglue CLI fournit une compétence qui apprend aux agents d'IA de codage comment utiliser ses commandes, gérer l'authentification, construire des outils et déboguer les échecs. Au lieu de créer des outils pré-construits pour chaque intégration d'API, les agents peuvent lire les spécifications d'API au moment de l'exécution et planifier des appels en plusieurs étapes.
Hippo v0.21.0 : Mémoire bio-inspirée pour agents IA avec support multi-outils
Hippo v0.21.0 introduit une configuration en une seule commande pour plusieurs outils de codage IA, dont Claude Code, OpenCode, OpenClaw, Codex, Cursor et Pi. Le système de mémoire intègre la dégradation, le renforcement de la récupération et la consolidation, sans dépendances d'exécution.
Claude Code à l'échelle : Comment la recherche agentique évite les modes de défaillance du RAG dans les grandes bases de code
Claude Code utilise une navigation agentive du système de fichiers plutôt qu'un RAG basé sur les embeddings, éliminant les problèmes d'index obsolètes. L'article détaille cinq points d'extension (CLAUDE.md, hooks, skills, plugins, MCP) et la philosophie du harnais en tant que modèle pour les dépôts de plusieurs millions de lignes.
agent-data : Données Web Structurées pour Agents OpenClaw, 70% Moins Cher que l'Automatisation de Navigateur
agent-data fournit des endpoints API Python purs pour X, Reddit, les vols et les offres d'emploi, conçus pour les agents IA comme OpenClaw : pas besoin d'automatisation de navigateur. Le benchmark montre des économies significatives et une fiabilité accrue.