beebjit-MCP

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.

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.

Project links

Data verified by PyPI on Jun 16, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for acscpt from gravatar.com acscpt

Credits

Author: acscpt

GitHub Statistics

Data verified by PyPI on Jun 16, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.10

Provides Extra

dev

Tags

bbc-micro acorn beebjit emulator mcp model-context-protocol retro 8bit llm ai-tools

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

beebjit_mcp-0.1.1.tar.gz (60.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

beebjit_mcp-0.1.1-py3-none-any.whl (40.2 kB view details)

Uploaded Python 3

File details

Details for the file beebjit_mcp-0.1.1.tar.gz.

File metadata

  • Download URL: beebjit_mcp-0.1.1.tar.gz
  • Upload date:
  • Size: 60.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for beebjit_mcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 b8e52500d18153ce87bbb93b13d6ad19a2286acf8f17b4dca2c06263663097b0
MD5 1916fff98d9a1f2ae303b49cc61a7de1
BLAKE2b-256 1d494f3570f041ce0fd4cf4a455a22f91babb8680b4cd6b1048e3707853e723a

See more details on using hashes here.

Provenance

The following attestation bundles were made for beebjit_mcp-0.1.1.tar.gz:

Publisher: publish.yml on acscpt/beebjit-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file beebjit_mcp-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: beebjit_mcp-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 40.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for beebjit_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 a5388742471713a2a2569805aac334497d85c404c37f29698b03446eb0307926
MD5 0e3099c2b9de1abe05980058ba779fdc
BLAKE2b-256 d75a733b8dfc2b865fd878ff6dc14eea3f1c28d683bcbe2dd48555bd81176930

See more details on using hashes here.

Provenance

The following attestation bundles were made for beebjit_mcp-0.1.1-py3-none-any.whl:

Publisher: publish.yml on acscpt/beebjit-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page