Allows LLM agents to flash pre-built STM32 and LPC ELF files onto real Nucleo and Discovery hardware boards via HTTPS.
También conocido como Tetef/cloudhildemo, cloudhildemo, cloudhil-mcp
- Stars
- 0
- Herramientas
- —
- Descargas, 30 días
- 213
- Última versión
- 0.8.2
- Último commit
- 11 sept 2026
- Licencia
- MIT
¿Qué es Cloudhil MCP?
Allows LLM agents to flash pre-built STM32 and LPC ELF files onto real Nucleo and Discovery hardware boards via HTTPS.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Cloudhil
Cloudhil provides a specialized interface for LLM agents to interact with physical embedded hardware. Instead of simulating environments, this server allows agents to flash pre-built STM32 and LPC ELF files directly onto real Nucleo and Discovery boards using HTTPS. This connection enables an AI to move beyond code generation and perform actual hardware testing on silicon.
The workflow requires the user to compile the firmware locally before sending the ELF file via a POST request. The server handles the flashing process, and the agent monitors the result.mailbox file to confirm success by looking for the NNOK hex code. This setup is designed for developers using tools like Cursor or Claude who want to verify their embedded code on physical microcontrollers.
Because the server never performs compilation itself, it remains a lightweight bridge between the digital agent and the physical MCU. The process is rapid, with the hardware erasure window lasting twenty seconds or less. This makes it a practical tool for rapid prototyping and hardware-in-the-loop validation within an AI-driven development workflow.
Qué puedes hacer con él
- 1Automated hardware testingInstruct the AI to perform a hardware test and report the results based on the mailbox status.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Cloudhil MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Cloudhil MCP en Claude Code
$ claude mcp add --env 'CLOUDHIL_API_KEY=<YOUR_CLOUDHIL_API_KEY>' cloudhildemo -- uvx cloudhil-mcpInstalar Cloudhil MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"cloudhildemo": {
"command": "uvx",
"args": [
"cloudhil-mcp"
],
"env": {
"CLOUDHIL_API_KEY": "<YOUR_CLOUDHIL_API_KEY>"
}
}
}
}Instalar Cloudhil MCP en VS Code
.vscode/mcp.json
{
"servers": {
"cloudhildemo": {
"type": "stdio",
"command": "uvx",
"args": [
"cloudhil-mcp"
],
"env": {
"CLOUDHIL_API_KEY": "<YOUR_CLOUDHIL_API_KEY>"
}
}
}
}Instalar Cloudhil MCP en VS Code CLI
$ code --add-mcp '{"name":"cloudhildemo","type":"stdio","command":"uvx","args":["cloudhil-mcp"],"env":{"CLOUDHIL_API_KEY":"<YOUR_CLOUDHIL_API_KEY>"}}'Instalar Cloudhil MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"cloudhildemo": {
"command": "uvx",
"args": [
"cloudhil-mcp"
],
"env": {
"CLOUDHIL_API_KEY": "<YOUR_CLOUDHIL_API_KEY>"
}
}
}
}Instalar Cloudhil MCP en Codex
$ codex mcp add cloudhildemo --env 'CLOUDHIL_API_KEY=<YOUR_CLOUDHIL_API_KEY>' -- uvx cloudhil-mcpInstalar Cloudhil MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.cloudhildemo] command = "uvx" args = ["cloudhil-mcp"] [mcp_servers.cloudhildemo.env] CLOUDHIL_API_KEY = "<YOUR_CLOUDHIL_API_KEY>"
Instalar Cloudhil MCP en Gemini CLI
$ gemini mcp add -s user -e 'CLOUDHIL_API_KEY=<YOUR_CLOUDHIL_API_KEY>' cloudhildemo uvx -- cloudhil-mcpInstalar Cloudhil MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"cloudhildemo": {
"command": "uvx",
"args": [
"cloudhil-mcp"
],
"env": {
"CLOUDHIL_API_KEY": "<YOUR_CLOUDHIL_API_KEY>"
}
}
}
}Configuración
CLOUDHIL_API_KEYSecretoBearer from register_agent (optional; the tool can register)
CLOUDHIL_URLCloudhil API base URL
| Nombre | Descripción | Tipo |
|---|---|---|
| CLOUDHIL_API_KEY | Bearer from register_agent (optional; the tool can register) | Secreto |
| CLOUDHIL_URL | Cloudhil API base URL |
Verificaciones automáticas
Ejecutado 15 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibletetef/cloudhildemo is public and reachablegithub.com/tetef/cloudhildemo ↗Aprobado
- El paquete indica este repositorio como su origencloudhil-mcp names tetef/cloudhildemo as sourcepypi.org/project/cloudhil-mcp/ ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-10github.com/tetef/cloudhildemo ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from cloudhil-mcpAprobado
- No hay avisos críticos en el paquete ni en sus dependencias1 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPinitialize answered with protocol 2025-06-18 in 684 msAprobado
README
Ver en GitHubcloudhildemo
Kit for LLM agents that want to flash real STM32 / LPC boards on Cloudhil.
Cloudhil never compiles. You compile locally, POST an ELF, read result.mailbox (NNOK = 0x4E4E4F4B), then the MCU is erased (≤20 s smoke window).
Files
AGENTS.md— paste into the firmware repo (AGENTS.mdor.cursorrules)SKILL.md— Cursor / Claude skill (offer hardware test, then say tested on silicon)hello/— NNOK hello.c + linker scripts + gcc one-liners (N6 recipe inside AGENTS.md)mcp/cloudhil_mcp.py— stdio MCP, Python 3, no pip
Official prebuilt hellos (not in git): https://cloudhil.tinab.com/hello/nucleo-n6.elf
Contact: contact@cloudhil.tinab.com
Preguntas sobre Cloudhil MCP
¿Cómo agrego Cloudhil MCP a Claude Code?
Ejecuta claude mcp add --env 'CLOUDHIL_API_KEY=<YOUR_CLOUDHIL_API_KEY>' cloudhildemo -- uvx cloudhil-mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Cloudhil MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
How do I know if the flashing was successful?
You can check the result.mailbox for the NNOK value (0x4E4E4F4B) to verify the process.
What happens to the MCU after flashing?
The MCU is erased within a window of 20 seconds or less.