genpark-stack-bytecode-virtual-machine-skill

Stack-based bytecode virtual machine interpreter supporting arithmetic, variable storage, and conditional jumps.

Part of the GenPark AI Agent Skills Matrix. Production-ready, zero external dependencies, native Python 3.9+ standard library.

Architecture

flowchart TD
    A[Source Code / Input Stream] --> B[Lexer & AST Parser]
    B --> C[Bytecode / Type Inference Core]
    C --> D[Evaluated Runtime State]
    D --> E[MCP Protocol Endpoint]

Features

• Zero Third-Party Dependencies: Pure Python standard library (re, math).
• Compiler Construction Fundamentals: Deterministic lexing, recursive descent parsing, stack bytecode VM, and Algorithm W unification.
• Native MCP Protocol Support: Integrated JSON-RPC 2.0 stdio server ready for Claude Desktop, Cursor, and Windsurf.

Installation

pip install genpark-stack-bytecode-virtual-machine-skill

Or clone directly:

git clone https://github.com/alphaparkinc/genpark-stack-bytecode-virtual-machine-skill.git
cd genpark-stack-bytecode-virtual-machine-skill
python example_usage.py

Quick Start

from client import *
# Refer to example_usage.py for end-to-end execution

Model Context Protocol (MCP) Setup

Add to your claude_desktop_config.json or cursor.json:

{
  "mcpServers": {
    "genpark-stack-bytecode-virtual-machine-skill": {
      "command": "python",
      "args": ["-m", "genpark-stack-bytecode-virtual-machine-skill.mcp_server"]
    }
  }
}

License

MIT License. Copyright (c) 2026 AlphaPark Inc. & Alpha-Park.