Micro Mcp
What is Micro Mcp
micro-mcp is a MCP server framework designed specifically for the BBC micro:bit and MakeCode, enabling users to create and manage projects easily.
Use cases
Use cases for micro-mcp include developing interactive projects, teaching programming concepts, and creating prototypes for IoT applications using the micro:bit.
How to use
To use micro-mcp, add it as an extension in MakeCode by visiting the MakeCode website, creating a new project, and importing the micro-mcp repository using its URL.
Key features
Key features of micro-mcp include easy integration with MakeCode, support for project editing, and a user-friendly interface for managing micro:bit projects.
Where to use
micro-mcp can be used in educational settings, particularly in programming and electronics classes, as well as in hobbyist projects involving the BBC micro:bit.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Micro Mcp
micro-mcp is a MCP server framework designed specifically for the BBC micro:bit and MakeCode, enabling users to create and manage projects easily.
Use cases
Use cases for micro-mcp include developing interactive projects, teaching programming concepts, and creating prototypes for IoT applications using the micro:bit.
How to use
To use micro-mcp, add it as an extension in MakeCode by visiting the MakeCode website, creating a new project, and importing the micro-mcp repository using its URL.
Key features
Key features of micro-mcp include easy integration with MakeCode, support for project editing, and a user-friendly interface for managing micro:bit projects.
Where to use
micro-mcp can be used in educational settings, particularly in programming and electronics classes, as well as in hobbyist projects involving the BBC micro:bit.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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.jsonfile 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.jsonfile and start the server - click on the
Toolsicon 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
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
