ByteAsk Embedded MCP : recherche de texte original paginé pour agents firmware

Pour qui

Si vous écrivez du firmware, un pilote ou du code de protocole et avez besoin d’un texte original avec numéros de page, plutôt que de laisser un modèle remplir registres ou clauses de mémoire, ce service correspond. Le texte officiel le décrit comme un MCP de recherche de preuves sourcé et cité par page pour agents de codage, et nomme Claude Code, Codex et Cursor.

Il convient à qui peut déjà brancher un MCP distant sur ces clients et traite des littéraux hexadécimaux, codes Modbus, clauses IEEE, verbes SCPI ou références MCU. Le texte officiel exige que l’agent appelle search_docs avant de répondre de mémoire.

Ce dépôt ne contient ni moteur de recherche ni corpus documentaire ; le matériel sous licence est derrière le point de terminaison hébergé. Le premier essai doit prendre le chemin hébergé. Ne traitez pas un processus stdio local comme s’il contenait déjà tout le corpus.

Réussir le premier essai en 3 minutes

La recherche complète rendue disponible officiellement est sur le point de terminaison hébergé. Prérequis : vous utilisez Claude Code, Codex ou Cursor, et pouvez ajouter un MCP distant.

Pointez le client vers cette ligne :

https://mcp.byteask.ai/mcp

Enregistrez, rechargez, confirmez que le service est connecté. Le nom d’enregistrement officiel est ai.byteask/embedded-docs, mais le premier essai n’a besoin que du point de terminaison hébergé.

Puis une recherche en lecture seule : appelez search_docs. Le texte officiel dit que l’agent doit d’abord chercher quand il voit des littéraux hexadécimaux, codes Modbus, clauses IEEE, verbes SCPI ou références MCU. Utilisez le numéro ou la clause que vous êtes en train d’écrire comme terme. N’inventez pas un numéro de composant ni une valeur de registre absents de cette page.

Signal de succès : des extraits de texte original avec citations de page reviennent ; s’ils ne sont pas assez pertinents, il renvoie no match au lieu de rédiger une réponse. Le texte officiel dit qu’il ne donne jamais d’authored answer. Ne lisez pas no match comme une autorisation d’inventer.

L’alternative locale est Python 3.10+ et uv, commande uv sync puis uv run byteask-embedded-mcp (stdio). Ne prenez pas ce chemin au premier essai : le texte officiel dit que le moteur et le corpus ne sont pas dans ce dépôt.

Cas d’usage

Cas 1 : en écrivant du MCU ou un pilote, d’abord vérifier littéraux hexadécimaux et références de composant. Appelez search_docs et envoyez un littéral hexadécimal ou une référence MCU déjà présents dans votre code. Le texte officiel en fait des déclencheurs de recherche, sans exemple de référence ni champs renvoyés. En cas de succès vous devez voir des extraits originaux paginés ; sur no match, arrêtez. Ne complétez pas les registres.

Cas 2 : en écrivant une pile protocole, vérifier codes Modbus, clauses IEEE ou verbes SCPI. Appelez search_docs de la même façon. Le texte officiel nomme ces trois indices de protocole et n’écrit ni syntaxe de recherche ni format de numéro de clause. N’utilisez que les champs search_docs affichés par le client. Le succès reste le texte original paginé ou un no match honnête. Ne le traitez pas comme un outil d’écriture pouvant réécrire le corps de la norme.

Limites

Seul le point de terminaison hébergé relie le corpus sous licence dont parle le texte officiel. Ce que ce dépôt ouvre est la coquille du serveur MCP ; moteur, découpage, plongements, classement et matériel sous licence ne sont pas dans le dépôt. uv run byteask-embedded-mcp en local n’est documenté que comme lancement stdio ; n’en déduisez pas que les mêmes documents existent déjà en local.

Ce qui revient, ce sont des extraits originaux plus des numéros de page, pas une réponse rédigée. Sans hit assez pertinent, il dit no match. Les requêtes sortent vers le point de terminaison hébergé et peuvent exposer le composant ou l’indice de protocole consulté. Le texte officiel n’écrit ni limite de débit ni annulation.

Ne traitez pas un site docs ou des fichiers d’implémentation backend comme une autre entrée d’installation. Le premier essai ne connecte que le MCP hébergé et n’appelle que search_docs.