micro-mcp

micro-mcp

BBC micro:bit を Model Context Protocol（MCP）サーバーにする

このライブラリを使うと、TypeScript で MCP ツールを定義し（ブロックには未対応です）、 ブリッジスクリプトを使って stdio 経由で MCP クライアントに接続できます。

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

例

この例では、micro:bit の LED マトリックスに数字を表示するツールの定義方法を示します。

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

MCP サーバーをテストするには、このリポジトリの bridge スクリプトを使用できます。

• 依存関係をインストールします

npm ci

• このリポジトリのルートに .vscode/mcp.json ファイルを作成し、次の内容を記述します。

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

• GitHub Copilot Chat を開きます
• mcp.json ファイルを開いてサーバーを起動します
• Tools アイコンをクリックし、ツールが一覧に表示され、選択されていることを確認します
• プロンプトを入力します！

拡張機能として使用

このリポジトリは MakeCode に拡張機能として追加できます。

• https://makecode.microbit.org/ を開きます
• New Project をクリックします
• 歯車メニューの Extensions をクリックします
• https://github.com/pelikhan/micro-mcp を検索してインポートします

このプロジェクトを編集

Visual Studio Code を使ってこのプロジェクトを編集します。

メタデータ（検索、レンダリング用）

• PXT/microbit 用