micro-mcp

What is micro-mcp?

micro-mcp turns your BBC micro:bit into a Model Context Protocol (MCP) server. It lets you define MCP tools in TypeScript and uses a bridge script to connect to an MCP client via stdio.

How to use micro-mcp?

Install dependencies with npm ci, then create a .vscode/mcp.json file pointing to the bridge script (bridge.mjs). Open GitHub Copilot Chat, start the server from the mcp.json file, and verify tools are listed. You can also add it as an extension in MakeCode by searching for https://github.com/pelikhan/micro-mcp.

Key features of micro-mcp

• Define MCP tools in TypeScript (blocks not yet supported)
• Display data on the micro:bit's 5×5 LED matrix
• Connect to MCP clients via stdio transport
• Works with GitHub Copilot Chat in VS Code
• Can be added as an extension in MakeCode

Use cases of micro-mcp

• Creating a virtual number display controlled by an AI assistant
• Experimenting with physical computing and LLM tool integration
• Teaching coding by combining micro:bit hardware with AI chat

FAQ from micro-mcp

How do I define a tool for the micro:bit?

Use the mcp.tool() function with a definition (name, description, inputSchema) and a handler; then call mcp.startServer().

What runtime is required?

The bridge script runs on Node.js; the micro:bit code runs in the MakeCode / PXT environment.

Where does data live?

Tool definitions and state are local to the micro:bit and the connected client; no external server is used.

What transport does it use?

Stdio via the bridge script.

Can I use it without Visual Studio Code?

The README only describes usage via VS Code and MakeCode extension; other clients are not documented.