Pont MCP

Les agents parlent à la fenêtre via le Model Context Protocol, à travers une socket Unix et un petit sidecar. Aucun port réseau, aucun compte, aucun relais dans le cloud.

Chaîne

client agent ──stdio JSON-RPC──► spark-mcp (sidecar)
                                      │ socket Unix
                                      ▼
                             fenêtre Spark (attachMcp)
                                      │
                                      ▼
                             runtime / registre / workspace
  • src-tauri/src/bin/spark-mcp.rs est déclaré comme binaire externe et livré dans le bundle.
  • Le serveur Rust crée run/mcp.sock dans le dossier de configuration, en 0600.
  • attachMcp transmet chaque ligne à la fenêtre et renvoie la réponse.
  • Si Spark est fermé, le pont répond spark_not_running et sert la dernière liste d’outils connue, pour qu’un client n’ait pas à redémarrer.

Outils

OutilRôle
spark_briefRésumé court de l’onglet actif ou ciblé.
spark_tabsOnglets et leur mode de disposition.
spark_tilesCatalogue compact des types de tuiles, actions et disponibilité ; detail: "full" ajoute descriptions et schémas.
spark_tab_openCrée un onglet en arrière-plan.
spark_tab_closeFerme un onglet ; refusé si un document non enregistré s’y oppose.
spark_tab_focusActive un onglet.
spark_tile_openOuvre une tuile et renvoie sa référence.
spark_tile_readLit la surface, les données et les actions d’une tuile.
spark_tile_callExécute une action déclarée.
spark_tile_closeFerme une tuile.
spark_tile_movePlace une tuile à côté d’une autre, ou comme onglet de son groupe.
spark_tile_resizeDonne à une tuile une largeur ou une hauteur en fraction de l’onglet.
spark_undoAnnule une opération de disposition.
spark_redoRétablit une opération de disposition.
spark_events_sinceReprend le journal depuis une séquence.

La liste est volontairement stable : un client la met en cache et la rafraîchit mal. Ce qui varie, ce sont les actions, découvertes par tuile avec spark_tiles etspark_tile_read.

Contrats

  • Résultats bornés. Une action qui renvoie plus de 16 000 caractères est refusée ; elle doit renvoyer un identifiant ou un résumé.
  • Surfaces. api.tiles.publish est un résumé volatil de 2 000 caractères, jamais persisté.
  • Guides. Le guide d’un type de tuile fait au plus 1 200 caractères et n’est livré qu’une fois par session, au premier catalogue ou à la première lecture.
  • Services. Une action qui déclare requires est masquée quand le service manque, et refusée à l’appel.
  • Mutations. Une action marquée mutates est annoncée comme telle puis exécutée ; demander confirmation revient au client qui appelle.
  • Attribution. Toute action passée par spark_tile_call est journalisée avec source: "agent".
  • Focus. Les onglets ouverts par un agent restent en arrière-plan et affichent un point discret dans la barre jusqu’à leur ouverture.
  • Contenu. Aucune action MCP ne lit ou n’écrit le contenu d’un terminal, et aucune ne renvoie un document.

Brancher un client

{
  "mcpServers": {
    "spark": {
      "command": "/Applications/Spark.app/Contents/MacOS/spark-mcp"
    }
  }
}

Le chemin absolu est celui affiché par l’engrenage en bas du rail, sousConnecter un agent…, avec un bouton pour copier. Spark détecte aussi une commande d’agent connue dans un terminal et propose d’écrire la configuration du client en un clic ; la session en cours voit le serveur à son redémarrage suivant.

Cycle de vie

  • registry.subscribeTools émet notifications/tools/list_changed quand une extension est activée, désactivée ou importée.
  • spark_tiles est recalculé à chaque appel : une nouvelle extension apparaît sans redémarrer le client.
  • Le sidecar met en cache la liste d’outils pour répondre quand la fenêtre est fermée. Un nouvel outil noyau demande quand même une nouvelle session côté client.