Allows LLM agents to flash pre-built STM32 and LPC ELF files onto real Nucleo and Discovery hardware boards via HTTPS.
別名 Tetef/cloudhildemo, cloudhildemo, cloudhil-mcp
- スター
- 0
- ツール
- —
- ダウンロード数(30日間)
- 213
- 最新バージョン
- 0.8.2
- 最終コミット
- 2026年9月11日
- ライセンス
- MIT
Cloudhil MCPとは
Allows LLM agents to flash pre-built STM32 and LPC ELF files onto real Nucleo and Discovery hardware boards via HTTPS.
プロジェクトのREADMEから生成された概要
Cloudhil MCP server について
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.
できること
- 1Automated hardware testingInstruct the AI to perform a hardware test and report the results based on the mailbox status.
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Cloudhil MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにCloudhil MCPをインストール
$ claude mcp add --env 'CLOUDHIL_API_KEY=<YOUR_CLOUDHIL_API_KEY>' cloudhildemo -- uvx cloudhil-mcpCursorにCloudhil MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"cloudhildemo": {
"command": "uvx",
"args": [
"cloudhil-mcp"
],
"env": {
"CLOUDHIL_API_KEY": "<YOUR_CLOUDHIL_API_KEY>"
}
}
}
}VS CodeにCloudhil MCPをインストール
.vscode/mcp.json
{
"servers": {
"cloudhildemo": {
"type": "stdio",
"command": "uvx",
"args": [
"cloudhil-mcp"
],
"env": {
"CLOUDHIL_API_KEY": "<YOUR_CLOUDHIL_API_KEY>"
}
}
}
}VS Code CLIにCloudhil MCPをインストール
$ code --add-mcp '{"name":"cloudhildemo","type":"stdio","command":"uvx","args":["cloudhil-mcp"],"env":{"CLOUDHIL_API_KEY":"<YOUR_CLOUDHIL_API_KEY>"}}'Claude DesktopにCloudhil MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"cloudhildemo": {
"command": "uvx",
"args": [
"cloudhil-mcp"
],
"env": {
"CLOUDHIL_API_KEY": "<YOUR_CLOUDHIL_API_KEY>"
}
}
}
}CodexにCloudhil MCPをインストール
$ codex mcp add cloudhildemo --env 'CLOUDHIL_API_KEY=<YOUR_CLOUDHIL_API_KEY>' -- uvx cloudhil-mcpCodex config.tomlにCloudhil MCPをインストール
~/.codex/config.toml
[mcp_servers.cloudhildemo] command = "uvx" args = ["cloudhil-mcp"] [mcp_servers.cloudhildemo.env] CLOUDHIL_API_KEY = "<YOUR_CLOUDHIL_API_KEY>"
Gemini CLIにCloudhil MCPをインストール
$ gemini mcp add -s user -e 'CLOUDHIL_API_KEY=<YOUR_CLOUDHIL_API_KEY>' cloudhildemo uvx -- cloudhil-mcpGemini settings.jsonにCloudhil MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"cloudhildemo": {
"command": "uvx",
"args": [
"cloudhil-mcp"
],
"env": {
"CLOUDHIL_API_KEY": "<YOUR_CLOUDHIL_API_KEY>"
}
}
}
}設定
CLOUDHIL_API_KEYシークレットBearer from register_agent (optional; the tool can register)
CLOUDHIL_URLCloudhil API base URL
| 名前 | 説明 | 種類 |
|---|---|---|
| CLOUDHIL_API_KEY | Bearer from register_agent (optional; the tool can register) | シークレット |
| CLOUDHIL_URL | Cloudhil API base URL |
自動チェック
実行日 2026年11月15日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能tetef/cloudhildemo is public and reachablegithub.com/tetef/cloudhildemo ↗合格
- パッケージがこのリポジトリをソースとして指定cloudhil-mcp names tetef/cloudhildemo as sourcepypi.org/project/cloudhil-mcp/ ↗合格
- ビルドの来歴 (Sigstore 証明)No build attestation published for this release未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-10github.com/tetef/cloudhildemo ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from cloudhil-mcp合格
- パッケージおよびその依存関係に重大な勧告なし1 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答initialize answered with protocol 2025-06-18 in 684 ms合格
README
GitHubで見るcloudhildemo
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
Cloudhil MCPのよくある質問
Cloudhil MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'CLOUDHIL_API_KEY=<YOUR_CLOUDHIL_API_KEY>' cloudhildemo -- uvx cloudhil-mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Cloudhil MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
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.