MCP server development guide — agent-centric tool design
Construire des serveurs MCP de haute qualité en Python (FastMCP) ou TypeScript — principes de design centrés agent, phases d'implémentation, checklist de revue et harnais d'évaluation
- Quoi
- Construire des serveurs MCP de haute qualité en Python (FastMCP) ou TypeScript — principes de design centrés agent, phases d'implémentation, checklist de revue et harnais d'évaluation
- Coût
- Gratuit
- Prérequis
- une API de service à intégrer et une configuration capable de MCP (toolchains Python ou Node/TypeScript) — le skill est un guide de développement que l'agent suit, pas un logiciel
- Installation
- Copiez le prompt d’installation ci-dessous dans votre Muse — votre agent fait le reste.
Sélectionné par Skill Harbor — fiche courte (le repo ne déclare aucune licence — ses termes vivent dans un LICENSE.txt que le manifest n'a pas pu confirmer, donc aucun contenu n'est reproduit) : le skill mcp-builder de @composiohq — le guide pour créer des serveurs MCP de haute qualité en Python (FastMCP) ou Node/TypeScript (SDK MCP). Phase 1 : recherche approfondie et planification — principes de design centrés agent (construire pour des workflows, pas des endpoints API ; optimiser pour le contexte limité ; messages d'erreur actionnables ; subdivisions naturelles des tâches ; développement piloté par évaluation), étudier la doc du protocole et des SDK MCP, étudier exhaustivement la doc de l'API cible, puis écrire un plan d'implémentation (sélection d'outils, utilitaires partagés, design entrées/sorties, stratégie de gestion d'erreurs). Phase 2 : implémentation — setup du projet, infrastructure de base d'abord, implémentation systématique des outils (schémas Pydantic/Zod, docstrings complètes, annotations comme readOnlyHint/idempotentHint), bonnes pratiques par langage. Phase 3 : revue et raffinement — revue DRY/composabilité/cohérence/typage, tests sûrs (ne jamais lancer le serveur dans le processus principal), checklists qualité. Phase 4 : évaluations — 10 questions d'évaluation complexes, réalistes, en lecture seule et vérifiables dans un format XML prescrit. Bémols honnêtes : guidance seulement — l'agent doit déjà utiliser Claude Code et a besoin d'une API de service à intégrer ; concept similaire à la fiche existante `anthropics-mcp-builder` (auteur différent, contenu différent — pas un doublon) ; termes de licence dans le LICENSE.txt du repo, non vérifiés ici — fiche courte avec lien uniquement, rien copié. Skill Harbor ne vérifie jamais le code, examinez-le vous-même avant usage. Découvert via skills.sh.
Version :
Installation
Prérequis : une API de service à intégrer et une configuration capable de MCP (toolchains Python ou Node/TypeScript) — le skill est un guide de développement que l'agent suit, pas un logiciel Installe-moi « Guide de développement de serveurs MCP — design d'outils centré agent ». Il donne à mon agent le workflow en 4 phases de @composiohq pour les serveurs MCP : recherche approfondie et planification (principes de design centrés agent, étude du protocole et des SDK, étude exhaustive de l'API, plan d'implémentation), implémentation (utilitaires partagés d'abord, implémentation systématique des outils avec schémas Pydantic/Zod et annotations, bonnes pratiques par langage), revue et raffinement (revue qualité, tests sûrs, checklists), et évaluations (10 questions complexes en lecture seule et vérifiables en XML). Lié mais distinct de la fiche existante anthropics-mcp-builder. IMPORTANT : les termes de licence vivent dans le LICENSE.txt du repo (non vérifiés) — récupérer depuis le lien seulement, et ne rien reproduire au-delà du lien. Dépôt : https://github.com/composiohq/awesome-claude-skills/blob/main/mcp-builder/SKILL.md 1. Récupère le fichier SKILL.md (et les fichiers d'aide éventuels) depuis le chemin du dépôt dans un dossier temporaire et résume en une ou deux phrases ce qu'il fait. 2. Vérification de sécurité : examine le SKILL.md et les scripts pour tout contenu suspect (appels réseau inattendus, commandes shell, collecte d'identifiants). Ce dépôt ne devrait contenir aucun secret en dur. Vérifie que c'est bien le cas ici ; STOP sur tout signal d'alerte et dis-le-moi. 3. Installe-le comme skill : copie le SKILL.md et ses fichiers d'aide dans le répertoire des skills de l'agent, dans un dossier nommé « mcp-builder ». 4. Vérifie sans appels réseau : frontmatter valide, fichiers en place. 5. Indique ce qui a été installé, où, et ce qu'il me reste à faire moi-même (p. ex. dire à l'agent quelle API de service transformer en serveur MCP ; rien d'autre — c'est un guide). GitHub est optionnel : si j'ai un compte GitHub ou la CLI gh, tu peux l'utiliser ; sinon l'accès public suffit. Ne jamais l'exiger sauf s'il figure dans les prérequis ci-dessus. Règles : ne touche à rien en dehors du dossier temporaire et de la cible d'installation. Si quelque chose semble anormal, arrête-toi et demande-moi.
Questions
Comment installer une création ?
Chaque fiche produit contient un prompt d’installation à copier-coller. Collez-le dans votre Muse et il installe la création pour vous — sans configuration manuelle.
Où va mon argent ?
Directement au vendeur. Skill Harbor ne traite jamais les paiements : le paiement se fait sur la page du vendeur, généralement via Stripe.
Que signifie le ✓ à côté du nom d’un créateur ?
Il signifie que nous avons confirmé l’identité de la personne derrière la fiche. Il ne dit rien sur le code lui-même — vérifiez toujours une création avant de l’installer.