micro-mcp

将你的BBC micro:bit变成一个模型上下文协议 (MCP) 服务器

通过这个库，你可以用TypeScript定义MCP工具（目前不支持代码块），并使用桥接脚本通过标准输入输出连接到MCP客户端。

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

示例

此示例展示了如何定义一个在micro:bit的LED矩阵上显示数字的工具。

mcp.tool({
    definition: {
        name: "show_number",
        description: "在5x5的LED矩阵上显示一个数字",
        inputSchema: {
            type: "object",
            properties: {
                number: { type: "integer", description: "要显示的整数" }
            },
            required: ["number"]
        },
        annotations: {
            title: "显示数字",
            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文件并启动服务器
• 点击“工具”图标，确保你的工具已列出并被选中
• 开始提示！

作为扩展使用

此仓库可以作为扩展添加到MakeCode中。

• 打开https://makecode.microbit.org/
• 点击新建项目
• 点击齿轮菜单下的扩展
• 搜索https://github.com/pelikhan/micro-mcp 并导入

编辑此项目

使用Visual Studio Code编辑此项目。

元数据（用于搜索和渲染）

• 适用于 PXT/microbit