Serveur MCP

joppa mcp est un serveur MCP (Model Context Protocol) sur stdio. Un assistant de code y voit vos projets et leurs domaines, démarre les services, lit leurs journaux, crée des bases ou des projets et lit le .env.

Brancher un assistant

Le plus simple : Réglages › Ligne de commande › Brancher les assistants. Ou depuis le terminal :

joppa mcp install                           # Claude Code, Claude Desktop et Cursor, ceux qui sont installés
joppa mcp install --client cursor --dry-run # montre ce qui serait écrit
joppa mcp uninstall

Client	Où Joppa s’inscrit
Claude Code	claude mcp add --scope user, sinon son fichier de config
Claude Desktop	claude_desktop_config.json
Cursor	~/.cursor/mcp.json

Seule l’entrée mcpServers.joppa est écrite, le reste du fichier ne bouge pas. Redémarrez l’assistant ensuite.

--client accepte claude-code, claude-desktop, cursor ou all.

Les outils

Outil	Rôle
get_status	État du proxy, de la CA, des projets et des services
list_projects	Les projets, leurs domaines et leur santé
list_services	Les services et leur état
start_service, stop_service	Démarre ou arrête un service
service_logs	Le journal d’un service (lines : 100 par défaut, 2 000 au plus)
list_databases	Les bases d’un serveur et leurs URL
create_database	Crée une base (service, name, extensions)
get_env	Le .env d’un projet, secrets masqués sauf avec reveal
start_proxy, stop_proxy	Démarre ou arrête le proxy
set_route_enabled	Active ou désactive un domaine
add_project	Ajoute un dossier, avec ses domaines détectés ou donnés
add_service	Ajoute un service (engine, version, port, start)
list_templates	Les modèles de projet et leurs options
create_project	Crée un projet depuis un modèle (dry_run pour voir les commandes)
create_project_status	Suit ou annule une création en cours
open_app	Affiche la fenêtre de Joppa

Exemples de demandes

• « Démarre PostgreSQL et crée une base blog avec pgvector. »
• « Pourquoi api.kinosante.test est hors ligne ? Regarde les logs. »
• « Crée un projet Astro docs dans ~/Code et ajoute-le à Joppa. »