Intégration de modèles (MCP/Agent)¶

Cet article vous explique comment connecter FIRERPA aux grands modèles de langage (basé sur MCP ou des commandes). FIRERPA a implémenté en interne le protocole serveur MCP ainsi que la fonctionnalité native tool-call d'OpenAI, vous permettant d'écrire vos propres plugins MCP et de les servir via le port standard 65000, ou d'hériter de la classe Agent pour implémenter des appels tools entièrement automatiques.

Commande Agent intégrée¶

Avec la commande agent intégrée, vous pouvez rapidement accomplir des tâches en langage naturel via un grand modèle de langage. Elle prend en charge n'importe quel fournisseur de services compatible avec l'API OpenAI + toolcall ou des services auto-hébergés. En combinaison avec le crontab intégré, vous pouvez programmer l'exécution de tâches en langage naturel.

Astuce

La commande `agent` doit être utilisée dans le terminal intégré, et vous devez fournir une API et une clé valides. Les performances peuvent varier entre les différents grands modèles de langage, veuillez choisir celui qui vous convient le mieux. Nous recommandons gemini, openai, deepseek, glm, etc.

Nom du paramètre	Type	Requis	Valeur par défaut	Description
`--api`	Chaîne (str)	Oui	-	Point de terminaison de l'API
`--model`	Chaîne (str)	Oui	-	Nom du modèle
`--temperature`	Flottant (float)	Non	`0.2`	Température d'échantillonnage du modèle
`--key`	Chaîne (str)	Oui	-	Clé d'API pour l'authentification
`--vision`	Booléen (bool)	Non	`False`	Activer le mode vision
`--imsize`	Entier (int)	Non	`1000`	Taille de l'image en mode vision
`--prompt`	Chaîne (str)	Oui	-	Instruction à exécuter par l'agent (Agent)
`--max-tokens`	Entier (int)	Non	`16384`	Nombre maximal de tokens à générer
`--step-delay`	Flottant (float)	Non	`0.0`	Délai entre les étapes

Attention

Il est important de noter que l'adresse du paramètre API est l'adresse complète, et non la `base_url`. Généralement, il faut ajouter `/chat/completions` après la `base_url` pour former l'adresse API complète.

Une fois que vous avez les informations nécessaires, vous pouvez entrer la commande suivante dans le terminal du bureau à distance pour que l'IA contrôle automatiquement votre appareil.

agent --api https://generativelanguage.googleapis.com/v1beta/openai/chat/completions --key VOTRE_CLÉ_API --model gemini-2.5-flash --prompt "Aide-moi à ouvrir l'application Paramètres, nom du package com.android.settings, trouver les paramètres réseau et activer le mode avion"

Si votre invite de tâche est trop longue, vous pouvez également la fournir au modèle via un fichier.

agent --api https://generativelanguage.googleapis.com/v1beta/openai/chat/completions --key VOTRE_CLÉ_API --model gemini-2.5-flash --prompt /chemin/vers/prompt.txt

Intégration de Claude & Cursor (MCP)¶

Cette section explique comment intégrer la fonctionnalité MCP de FIRERPA à votre client de grand modèle de langage. Nous fournissons des exemples uniquement pour Claude et Cursor, mais vous pouvez l'utiliser avec n'importe quel autre client prenant en charge le protocole MCP.

Remarque

Le service MCP intégré de FIRERPA prend en charge `tool-call`, `resource-read`, les `prompts`, ainsi que les notifications de progression et les journaux.

Attention

Veuillez noter que les protocoles de communication des serveurs 8.0 et 9.0 sont différents : 9.x utilise `streamable-http`, tandis que 8.x utilise `sse`.

Installer l'extension officielle¶

Nous fournissons un service MCP officiel. Vous pouvez télécharger ce module d'extension sur extensions/firerpa.py. Vous pouvez également vous référer à sa méthode d'écriture pour créer ou étendre vous-même les fonctionnalités du plugin. Après avoir téléchargé le script du plugin d'extension, téléversez-le dans le répertoire /data/usr/modules/extension de l'appareil via le bureau à distance ou un push manuel, puis redémarrez l'appareil ou le service FIRERPA.

Attention

Les scripts d'extension pour la version 8.0 et la version 9.0 ne sont pas compatibles. Veuillez vérifier attentivement la version de votre serveur et récupérer le script correspondant depuis la branche GitHub appropriée.

Utiliser l'extension officielle¶

Pour Claude, vous devez d'abord accéder à la page des paramètres de Claude et suivre les étapes illustrées ci-dessous. Ensuite, suivez les instructions pour modifier le fichier de configuration claude_desktop_config.json de Claude et y ajouter la configuration de service MCP JSON suivante.

{"mcpServers": {"firerpa": {"command": "npx", "args": ["-y", "supergateway", "--streamableHttp", "http://192.168.0.2:65000/firerpa/mcp/"]}}}

Exemple

Pour Cursor, vous devez ouvrir les Paramètres de Cursor (Cursor Settings), suivre les étapes illustrées et entrer la configuration suivante.

{"mcpServers": {"firerpa": {"url": "http://192.168.0.2:65000/firerpa/mcp/"}}}

Exemple

Attention

Veuillez vous assurer de remplacer le lien dans la configuration par l'adresse IP de votre propre appareil.

Écrire une extension MCP¶

Astuce

Documentation bientôt disponible.