convez.ai
MCP ServerDevOps & InfraestruturaAvançado
acscpt

beebjit-MCP

acscpt/beebjit-mcp

Controle um emulador BBC Micro via MCP com agentes de IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP em Python que integra o emulador BBC Micro (beebjit) com ferramentas de IA, permitindo que agentes controlem o emulador de forma estruturada. Possibilita boot de máquinas BBC, digitação de comandos, leitura de RAM, execução de programas BASIC e captura de tela — útil para testes automatizados, CI/CD e exploração interativa de software retro.

Instalação

$npx convez-ai acscpt/beebjit-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v0.1.1
Issues abertas
0
Contribuidores
1

Casos de uso

  • Testes automatizados de software BBC Micro em CI/CD
  • Exploração interativa de programas BASIC legados
  • Validação de imagens de disco e saída de emulador em pipelines

Veredito

Ferramenta altamente especializada e bem construída para quem trabalha com emulação de máquinas retrô em automação. Nicho muito específico, mas execução profissional com testes, documentação e suporte a biblioteca Python nativa.

README

A tradução para o português deste README ainda está na fila.

beebjit-MCP

PyPI PyPI Downloads Python 3.10+ License: MIT Tests codecov

beebjit-MCP is a Python-based Model Context Protocol (MCP) server that lets an AI application instantiate, connect to, drive, capture output from, and interrogate a real BBC Micro emulator.

Ask an AI agent something like:

Boot a BBC Model B, then type PRINT "HELLO" at the BASIC prompt, and read the screen back.

A couple of seconds later HELLO appears in the tool-result pane. That's it.

beebjit-MCP drives Chris Evans' beebjit, a cycle-accurate, high-performance BBC Micro emulator written in C. Install and configure beebjit before using beebjit-MCP. The installation guide walks through it.

What the AI agent can do with it

  • Boot a BBC B, Master 128 (MOS 3.20 or 3.50), or Master Compact session, with or without a disc image. DFS images use .ssd / .dsd; ADFS images use .adl / .adf.

  • Type ASCII into the keyboard and have it land as real BBC keypresses. SHIFT handling, CAPS LOCK control, and special keys like arrows and function keys are all wired.

  • Wait for text to appear on the MODE 7 screen, or for the BASIC > prompt.

  • Read or write BBC Micro RAM, read 6502 register state, and disassemble 6502 instructions.

  • Run a whole BBC BASIC program one-shot and capture the final screen.

  • Tear everything down cleanly when the client disconnects.

Python library for testing and CI/CD

The same package is a Python library as well as an MCP server. BeebjitDriver exposes the same operations as methods on an in-process class, with no MCP client or JSON-RPC framing in between.

A pytest run boots a BBC, exercises a disc image, runs a program, and asserts on the resulting screen or memory, in-process and headless. The same run sits inside a GitHub Actions job, and a disc-image toolchain calls the library to check that its output boots on a cycle-accurate machine.

from beebjit_mcp import BeebjitDriver, BeebModel
from beebjit_mcp.screen import mode7TextContains


def test_hello_boots():
    with BeebjitDriver.fromEnvironment(model=BeebModel.B) as bbc:
        bbc.runCycles(2_000_000)              # boot to the BASIC prompt
        bbc.typeText('PRINT "HELLO"\n')
        bbc.runCycles(2_000_000)
        assert mode7TextContains(bbc.captureMode7Bytes(), "HELLO")

The Python API covers each method, and the worked example boots a BBC, runs a colour MODE 7 program, and writes a PNG of the screen.

Licence

MIT. See LICENSE.

beebjit is GPLv3 and is never bundled in this repository or its release artefacts; the user installs beebjit themselves.

Acknowledgements

Thanks to Chris Evans (scarybeasts@gmail.com), creator and maintainer of beebjit. Without his work, none of this would exist.

Fork Notice

beebjit-MCP currently depends on a fork of beebjit that carries the small set of fixes and flags it needs. See installation for the exact list.

Disclaimer

beebjit-MCP is a separate project from beebjit, and is not affiliated with, sponsored, or endorsed by Chris Evans or the beebjit project.

For the canonical beebjit source and documentation, see scarybeasts/beebjit.

Ver o original no GitHub

Bom para

Relacionados