jezweb/mcp-builder

Que fait mcp-builder ?

Construisez des serveurs MCP en Python avec FastMCP. Définissez des outils / ressources / prompts, construisez le serveur, testez localement, déployez sur FastMCP Cloud ou Docker. Utilisez ce skill lorsque l'utilisateur mentionne la construction d'un serveur MCP, l'exposition d'outils aux LLMs, FastMCP, l'intégration avec Claude, ou le dépannage d'erreurs liées aux serveurs modulaires FastMCP, au stockage, au lifespan, au middleware, à OAuth ou au déploiement.

Prérequis

• Python 3.10+
• uv (recommandé) ou pip
• Compte FastMCP Cloud (optionnel pour le déploiement cloud)
• Docker (optionnel pour le déploiement Docker)

Utilisation

1. Initialiser un nouveau projet

uv init mcp-server
cd mcp-server
uv add fastmcp

2. Définir des outils

from fastmcp import FastMCP

mcp = FastMCP("Mon Serveur")

@mcp.tool()
def calculer(a: int, b: int) -> int:
    """Additionne deux nombres."""
    return a + b

3. Définir des ressources

@mcp.resource("config://app")
def get_config() -> str:
    """Récupère la configuration."""
    return "{\"theme\": \"dark\"}"

4. Définir des prompts

@mcp.prompt()
def salutation(nom: str) -> str:
    return f"Bonjour {nom}, comment puis-je vous aider ?"

5. Tester localement

# Avec l'inspector MCP
mcp dev main.py

# Ou avec un client MCP comme Claude Code
mcp run main.py

6. Déployer sur FastMCP Cloud

mcp deploy main.py

7. Déployer avec Docker

FROM python:3.11-slim
WORKDIR /app
COPY . .
RUN pip install fastmcp
CMD ["mcp", "run", "main.py"]

Construire et exécuter :

docker build -t mcp-server .
docker run -p 8000:8000 mcp-server

Dépannage

• Erreur de serveur modulaire : Assurez-vous que toutes les fonctions de tool/resource/prompt sont définies avec les bons décorateurs et que FastMCP est correctement instancié.
• Erreur de stockage : Vérifiez que les chemins de stockage sont accessibles et que les permissions sont correctes.
• Erreur de lifespan : Utilisez @mcp.lifespan() pour gérer les cycles de vie du serveur.
• Erreur de middleware : Configurez le middleware via mcp.add_middleware().
• Erreur OAuth : Assurez-vous que les flux OAuth sont correctement configurés dans FastMCP.
• Erreur de déploiement : Vérifiez que les variables d'environnement nécessaires sont définies et que le réseau est accessible.

Ressources supplémentaires

• Documentation FastMCP
• Dépôt FastMCP GitHub
• Console FastMCP Cloud

Ce skill est maintenu par jezweb. Signalez les problèmes sur GitHub.