mcpField
M
micro-mcp

micro-mcp

Local
pelikhan.github.ioDeveloper Tools12Updated 73w ago
RepositoryVisit website

About micro-mcp

micro-mcp is a TypeScript framework for defining MCP tools on a BBC micro:bit. Its bridge script connects the device-side server to an MCP client over stdio.

Key features

  1. 01Define MCP tools in TypeScript
  2. 02Connect through a stdio bridge script
  3. 03Use with MakeCode extensions
  4. 04Example for displaying numbers on the LED matrix

Use cases

  1. 01Expose a micro:bit LED display as a tool
  2. 02Test device tools with Visual Studio Code
  3. 03Add the library as a MakeCode extension

MCP support

Lets developers define MCP tools for a BBC micro:bit and connect them to an MCP client via the repository's stdio bridge script.

#micro-mcp#bbc-microbit#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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.

Edit this project

Use Visual Studio Code to edit this project.

Metadata (used for search, rendering)
  • for PXT/microbit

ChatGPT Image Jun 4, 2025, 02_22_06 PM

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.