Serveur MCP pour Open Brush

Ce serveur MCP (Model Context Protocol) expose l'API d'Open Brush comme des outils utilisables par des LLMs via le protocole MCP.

Prrequis

• Python 3.10 ou suprieur
• Open Brush en cours d'excution avec l'API active (port 40074)
• Accs un client MCP (comme Claude Desktop)

Installation

1. Cloner ou tlcharger les fichiers

2. Installer les dpendances Python

pip install -r requirements.txt

1. Rendre le script excutable (optionnel sur Linux/Mac)

chmod +x openbrush_mcp_server.py

Configuration

Activer l'API dans Open Brush

1. Lancez Open Brush
2. Activez l'API HTTP dans les paramtres
3. L'API devrait tre accessible sur http://localhost:40074/api/v1

Configurer dans Claude Desktop

Ajoutez cette configuration votre fichier de configuration MCP de Claude Desktop :

Sur macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Sur Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "openbrush": {
      "command": "python",
      "args": [
        "/chemin/vers/openbrush_mcp_server.py"
      ]
    }
  }
}

Remplacez /chemin/vers/ par le chemin absolu vers le fichier.

Outils Disponibles

Le serveur expose de nombreux outils organiss par catgorie :

Dessin (Drawing)

• draw_paths - Dessiner plusieurs chemins
• draw_path - Dessiner un chemin simple
• draw_stroke - Dessiner un trait avec orientation et pression
• draw_polygon - Dessiner un polygone
• draw_text - Dessiner du texte
• draw_svg_path - Dessiner un chemin SVG

Pinceau (Brush)

• brush_set_type - Changer le type de pinceau
• brush_set_size - Dfinir la taille du pinceau
• brush_add_size - Modifier la taille du pinceau
• brush_set_path_smoothing - Dfinir le lissage
• brush_move - Dplacer le pinceau (position absolue)
• brush_translate - Dplacer le pinceau (relatif)
• brush_rotate - Rotation du pinceau (absolue)
• brush_turn - Rotation du pinceau (relative)
• brush_draw - Dessiner une ligne droite

Couleur (Color)

• color_set_rgb - Dfinir la couleur en RGB
• color_set_hsv - Dfinir la couleur en HSV
• color_set_html - Dfinir la couleur avec HTML/CSS
• color_add_rgb - Modifier la couleur (RGB)
• color_add_hsv - Modifier la couleur (HSV)

Modles 3D (Models)

• model_import - Importer un modle local
• model_web_import - Importer depuis une URL
• model_icosa_import - Importer depuis Icosa Gallery
• model_select - Slectionner un modle
• model_position - Positionner un modle
• model_rotation - Rotation d'un modle
• model_scale - chelle d'un modle
• model_delete - Supprimer un modle

Sauvegarde/Chargement (Save/Load)

• save_overwrite - Sauvegarder (craser)
• save_as - Sauvegarder sous...
• save_new - Nouvelle sauvegarde
• load_user - Charger un sketch utilisateur
• load_named - Charger par nom
• new_scene - Nouvelle scne

Camra (Camera)

• camera_move - Dplacer la camra (absolu)
• camera_translate - Dplacer la camra (relatif)
• camera_rotate - Rotation camra (absolue)
• camera_turn - Rotation camra (relative)
• spectator_move - Dplacer la vue spectateur

Slection (Selection)

• selection_select_all - Tout slectionner
• selection_invert - Inverser la slection
• selection_delete - Supprimer la slection
• selection_duplicate - Dupliquer la slection

Calques (Layers)

• layer_create - Crer un calque
• layer_set - Dfinir le calque actif
• layer_show - Afficher un calque
• layer_hide - Cacher un calque

Guides

• guide_add - Ajouter un guide (cube, sphere, etc.)
• guide_position - Positionner un guide
• guide_scale - chelle d'un guide

Symtrie (Symmetry)

• symmetry_mode - Mode de symtrie
• symmetry_position - Position du widget de symtrie

Utilitaires

• undo - Annuler
• redo - Refaire
• show_help - Afficher l'aide API

Exemples d'utilisation

Une fois le serveur configur dans Claude Desktop, vous pouvez donner des instructions en langage naturel :

"Dessine un carr rouge de taille 2  la position 0,0,0"
"Change le pinceau en 'ink' et dfinis la couleur en bleu"
"Cre un polygone  6 cts avec un rayon de 3"
"Importe le modle 'Andy.glb' et positionne-le en 1,2,3"
"Sauvegarde la scne sous le nom 'ma_creation'"

Test du serveur

Pour tester manuellement le serveur :

python openbrush_mcp_server.py

Le serveur devrait dmarrer et attendre des commandes sur stdin/stdout selon le protocole MCP.

Dpannage

L'API Open Brush n'est pas accessible

• Vrifiez qu'Open Brush est lanc
• Vrifiez que l'API HTTP est active dans les paramtres
• Testez manuellement : http://localhost:40074/api/v1?help

Le serveur MCP ne se connecte pas

• Vrifiez le chemin dans la configuration Claude Desktop
• Vrifiez que Python est dans le PATH
• Consultez les logs de Claude Desktop

Les commandes chouent

• Vrifiez les paramtres fournis
• Consultez la documentation de l'API Open Brush
• Vrifiez les messages d'erreur retourns

Ressources

• Documentation Open Brush
• Model Context Protocol (MCP)
• API Open Brush complte (quand Open Brush est lanc)

Scurit

Attention : Ce serveur appelle une API locale. Assurez-vous de :

• Ne pas exposer le port 40074 sur internet
• Faire confiance aux commandes envoyes
• Sauvegarder vos crations rgulirement

Licence

Ce serveur MCP est fourni tel quel pour faciliter l'utilisation d'Open Brush avec des LLMs.

Contribution

N'hsitez pas :

• Signaler des bugs
• Proposer des amliorations
• Ajouter de nouveaux outils pour les commandes API manquantes

---

Note : Open Brush est un fork open-source de Tilt Brush de Google. Ce serveur MCP n'est pas affili officiellement Open Brush.