Foxmayn Frappe CLI : ligne de commande et serveur MCP pour Frappe

Projet non officiel. Sans lien avec Frappe Technologies.

Ce que fait l'outil

ffc dialogue avec un site Frappe ou ERPNext via son API REST. Vous pouvez lire, créer, modifier, valider et annuler des documents depuis le terminal. Il s'adresse aux administrateurs, aux développeurs et à toute personne qui veut qu'un assistant IA comme Claude travaille sur son ERP.

Il agit toujours avec les permissions de l'utilisateur Frappe sous lequel vous vous connectez. Il ne peut pas faire plus que cet utilisateur dans Desk.

Fonctionnalités

• Documents : list-docs, get-doc, create-doc, update-doc, submit-doc, cancel-doc, bulk-update.
• Workflows : workflow apply.
• Recherche et impression : search, pdf.
• Fichiers : files upload, files download.
• Configuration : init crée un profil de site, whoami indique sous quel utilisateur vous êtes connecté.
• Options de sécurité : --dry-run montre ce qui serait modifié. --read-only bloque toute écriture.
• Serveur MCP : ffc mcp lance un serveur Model Context Protocol pour les assistants IA. Il est aussi livré sous forme de bundle .mcpb et référencé dans le registre MCP sous le nom io.github.nasroykh/ffc. Utilisez ffc mcp install et ffc mcp uninstall pour configurer les clients pris en charge.
• Application de bureau : ffc desktop install et ffc desktop status. L'application de bureau fonctionne sous Windows et macOS. C'est une préversion bêta (0.11.x) et n'est pas signée.
• Mises à jour : ffc update.

Installation

Linux et macOS :

curl -fsSL https://raw.githubusercontent.com/nasroykh/foxmayn_frappe_cli/main/install.sh | sh

Windows PowerShell :

irm https://raw.githubusercontent.com/nasroykh/foxmayn_frappe_cli/main/install.ps1 | iex

Homebrew :

brew install nasroykh/tap/ffc

Scoop :

scoop bucket add foxmayn https://github.com/nasroykh/scoop-bucket
scoop install ffc

Connectez ensuite votre premier site :

ffc init
ffc whoami

Les versions couvrent Linux, macOS (amd64 et arm64) et Windows (amd64 et arm64). Les sommes de contrôle sont signées en Ed25519, et le script d'installation les vérifie lorsque OpenSSL 3 est présent. La CI exécute go vet et go test avant chaque version, et le workflow de publication produit une attestation de provenance.

Pourquoi nous l'avons construit

Nous travaillons chaque jour sur des sites Frappe. Cliquer dans Desk pour vérifier un enregistrement ou en modifier cinquante est lent. Une ligne de commande scriptable est plus rapide, et elle s'intègre aux scripts shell et aux tâches de CI.

Les assistants IA rendent cela plus utile, et aussi plus risqué. Le serveur MCP leur donne un vrai accès à un site, mais seulement avec les permissions d'un utilisateur, et le mode --read-only permet de commencer par la lecture seule. Nous utilisons ffc dans notre propre travail d'IA sur ERPNext.

L'outil est écrit en Go et publié sous licence MIT. Retrouvez le code source, les versions et les tickets sur GitHub. Outils associés : Foxmayn Frappe Manager pour les benches et Foxmayn Frappe Types pour TypeScript.