micro-mcp

Turn your BBC micro:bit into a Model Context Protocol (MCP) server

With this library, you will be able to define MCP tools in TypeScript (blocks not yet)
and use the bridge script to connect to a MCP client via stdio.

https://github.com/user-attachments/assets/48418354-385a-45e9-bee1-7e36633dd243

Example

This example shows how to define a tool that displays a number on the micro:bit's LED matrix.

mcp.tool({
    definition: {
        name: "show_number",
        description: "Show a number on the 5 x 5 LED matrix",
        inputSchema: {
            type: "object",
            properties: {
                number: { type: "integer", description: "Integer to show" }
            },
            required: ["number"]
        },
        annotations: {
            title: "Show Number",
            idempotentHint: true,
        }
    },
    handler: (args: { number: number }) => {
        const number = args.number || 0;
        basic.showNumber(number);
        return ok;
    }
})
mcp.startServer()

Visual Studio Code

To test out the MCP server, you can use the bridge script in this repository.

- install dependencies

npm ci

- create a .vscode/mcp.json file in the root of this repository with the following content:

{
    "servers": {
        "micro-mcp": {
            "type": "stdio",
            "command": "node",
            "args": ["${workspaceFolder}/bridge.mjs"]
        }
    }
}

- open GitHub Copilot Chat
- open the mcp.json file and start the server
- click on the Tools icon and make sure your tool are listed and selected
- prompt away!

Use as Extension

This repository can be added as an extension in MakeCode.

open https://makecode.microbit.org/
click on New Project
click on Extensions under the gearwheel menu
search for https://github.com/pelikhan/micro-mcp and import

Edit this project

Use Visual Studio Code to edit this project.

Metadata (used for search, rendering)

• for PXT/microbit