MCP PyBoy Emulator Server

[build-system] requires = ["hatchling"] build-backend = "hatchling.build" [project] name = "mcp-pyboy" version = "0.1.0" description = "MCP server that enables LLMs to interact with Game Boy games through PyBoy emulation" readme = "README.md" license = "MIT" authors = [{ name = "Steven Simonitch", email = "ssimonitch@gmail.com" }] classifiers = [ "Development Status :: 3 - Alpha", "Framework :: AsyncIO", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.10", "Programming Language :: Python :: 3.11", "Programming Language :: Python :: 3.12", "Topic :: Games/Entertainment", "Topic :: Software Development :: Libraries :: Python Modules", ] requires-python = ">=3.10" # Core Dependencies dependencies = [ "mcp>=1.0.0", # MCP protocol implementation (includes FastMCP) "pyboy>=2.0.0", # Game Boy emulator engine "pydantic>=2.0.0", # Data validation and settings (used by FastMCP) "pillow>=10.0.0", # Image processing for screenshots "numpy>=1.24.0", # Numerical computing for screen data "aiofiles>=23.0.0", # Async file operations for notebook system "websockets>=15.0.1", ] # Optional dependencies for different features [project.optional-dependencies] dev = [ "pytest>=7.4.0", # Testing framework "pytest-asyncio>=0.21.0", # Async test support "pytest-mock>=3.11.0", # Mocking for tests "pytest-cov>=4.1.0", # Coverage reporting "black>=23.0.0", # Code formatting "ruff>=0.1.0", # Linting "mypy>=1.7.0", # Type checking "pre-commit>=3.0.0", # Pre-commit hooks ] test = [ "pytest>=7.4.0", "pytest-asyncio>=0.21.0", "pytest-mock>=3.11.0", "pytest-cov>=4.1.0", ] frontend = ["fastapi>=0.116.0", "uvicorn>=0.35.0", "websockets>=15.0.0"] [project.scripts] mcp-pyboy = "mcp_server.cli:main" format = "mcp_server.scripts.format:main" lint = "mcp_server.scripts.lint:main" test = "mcp_server.scripts.test:main" typecheck = "mcp_server.scripts.typecheck:main" web-server = "web_server.app:main" [project.urls] Homepage = "https://github.com/ssimonitch/mcp-pyboy" Repository = "https://github.com/ssimonitch/mcp-pyboy" Issues = "https://github.com/ssimonitch/mcp-pyboy/issues" Documentation = "https://ssimonitch.github.io/mcp-pyboy" # Hatch configuration [tool.hatch.build.targets.wheel] packages = ["src/mcp_server", "src/web_server", "src/web_frontend"] [tool.hatch.build.targets.sdist] include = ["/src", "/tests", "/docs", "/README.md", "/LICENSE"] # Black configuration [tool.black] line-length = 88 target-version = ['py310'] include = '\.pyi?$' extend-exclude = ''' /( # directories \.eggs | \.git | \.hg | \.mypy_cache | \.tox | \.venv | build | dist )/ ''' # Ruff configuration [tool.ruff] target-version = "py310" line-length = 88 [tool.ruff.lint] select = [ "E", # pycodestyle errors "W", # pycodestyle warnings "F", # pyflakes "I", # isort "B", # flake8-bugbear "C4", # flake8-comprehensions "UP", # pyupgrade ] ignore = [ "E501", # line too long, handled by black "B008", # do not perform function calls in argument defaults "C901", # too complex ] [tool.ruff.lint.per-file-ignores] "__init__.py" = ["F401"] "tests/*" = ["B011"] # Import sorting configuration (isort compatibility) [tool.ruff.lint.isort] known-first-party = ["mcp_server", "web_server"] force-single-line = false split-on-trailing-comma = true combine-as-imports = true # MyPy configuration [tool.mypy] python_version = "3.10" files = ["src/", "tests/"] check_untyped_defs = true disallow_any_generics = true disallow_incomplete_defs = true disallow_untyped_defs = true no_implicit_optional = true warn_redundant_casts = true warn_unused_ignores = true warn_return_any = true strict_optional = true [[tool.mypy.overrides]] module = ["pyboy.*", "mcp.*", "fastapi.*", "uvicorn.*"] ignore_missing_imports = true [[tool.mypy.overrides]] module = ["tests.*"] disallow_untyped_defs = false disallow_incomplete_defs = false check_untyped_defs = false # Pytest configuration [tool.pytest.ini_options] minversion = "7.0" addopts = [ "--strict-markers", "--strict-config", "--cov=src/mcp_server", "--cov-report=term-missing", "--cov-report=html", "--cov-report=xml", ] testpaths = ["tests"] markers = [ "slow: marks tests as slow (deselect with '-m \"not slow\"')", "integration: marks tests as integration tests", "unit: marks tests as unit tests", ] filterwarnings = [ "ignore:Using SDL2 binaries from pysdl2-dll:UserWarning:sdl2._internal", ] asyncio_mode = "auto" # Coverage configuration [tool.coverage.run] source = ["src"] omit = ["*/tests/*", "*/test_*.py", "*/__init__.py"] [tool.coverage.report] exclude_lines = [ "pragma: no cover", "def __repr__", "if self.debug:", "if settings.DEBUG", "raise AssertionError", "raise NotImplementedError", "if 0:", "if __name__ == .__main__.:", "class .*\\bProtocol\\):", "@(abc\\.)?abstractmethod", ] [dependency-groups] dev = ["mcp[cli]>=1.10.1"]