microbit-mcp

name	microbit-mcp
description	Edit and build micro:bit v2 CODAL projects via MCP.
metadata	{"clawdbot":{"emoji":"🤖","requires":{"anyBins":["node","node.exe"],"env":[],"config":[]},"homepage":"https://www.npmjs.com/package/microbit-claude-mcp"},"moltbot":{"requires":{"anyBins":["node","node.exe"],"env":[],"config":[]},"homepage":"https://www.npmjs.com/package/microbit-claude-mcp"}}

micro:bit MCP Skill

You have access to a local MCP server that edits and builds micro:bit v2 CODAL projects.

What this skill is for

• Validate a CODAL project layout
• Read and write source/main.cpp or other source files
• List C/C++ source files
• Run build.py to generate MICROBIT.hex

Operating constraints

• Always ask for a projectRoot path.
• Keep changes small and incremental.
• Prefer editing source/main.cpp unless the user explicitly asks for new files.
• Never write outside projectRoot.
• Building requires the micro:bit toolchain; if build fails, report the error and suggest installing prerequisites.

Starting the servers

Start the REST server:

• microbit-claude-mcp or node dist/index.js

Start the MCP stdio server:

• node build/mcp.js

If the REST API uses a non-default port, set MICROBIT_API_URL or MICROBIT_API_PORT before launching the MCP server.

Tool usage pattern

1. validate
2. read_source
3. write_source / append_source
4. list_sources (optional)
5. build (optional)
6. report MICROBIT.hex path