bad-ass-mcp 1.4.0__tar.gz

bad_ass_mcp-1.4.0/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: jabberwock

bad_ass_mcp-1.4.0/.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  lint:
+    runs-on: ubuntu-26.04
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.11"
+      - run: python -m pip install -U "pip>=26.2.2" "certifi>=2026.10.19"
+      - run: pip install ruff
+      - run: ruff check .
+      - run: ruff format --check .
+
+  test:
+    runs-on: ubuntu-26.04
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: python -m pip install -U "pip>=26.2.2" "certifi>=2026.10.19"
+      - run: pip install -e ".[dev]"
+      - run: pytest

bad_ass_mcp-1.4.0/.github/workflows/release.yml

@@ -0,0 +1,118 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  # ── Per-platform PyInstaller bundles ─────────────────────────────────
+  bundle:
+    strategy:
+      matrix:
+        include:
+          - os: macos-latest
+            extra: macos
+            name: macos
+            hidden: bad_ass_mcp.backend.macos
+          - os: windows-latest
+            extra: windows
+            name: windows
+            hidden: bad_ass_mcp.backend.windows
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0  # needed for hatch-vcs tag resolution
+
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.11"
+
+      # emSign/eMudhra CA incident (Oct 2026): old pip trusts the pulled
+      # roots via its vendored certifi, so upgrade before installing anything.
+      - name: Upgrade pip + certifi
+        run: python -m pip install -U "pip>=26.2.2" "certifi>=2026.10.19"
+
+      - name: Install
+        run: pip install pyinstaller ".[${{ matrix.extra }}]"
+
+      - name: Build standalone
+        shell: bash
+        run: |
+          pyinstaller \
+            --onedir \
+            --name bad-ass-mcp \
+            --collect-all anyio \
+            --hidden-import ${{ matrix.hidden }} \
+            src/bad_ass_mcp/server.py
+
+      - name: Zip (Unix)
+        if: runner.os != 'Windows'
+        run: cd dist && zip -r ../bad-ass-mcp-${{ matrix.name }}.zip bad-ass-mcp/
+
+      - name: Zip (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: Compress-Archive -Path dist/bad-ass-mcp -DestinationPath bad-ass-mcp-${{ matrix.name }}.zip
+
+      - uses: actions/upload-artifact@v7
+        with:
+          name: bundle-${{ matrix.name }}
+          path: bad-ass-mcp-${{ matrix.name }}.zip
+
+  # ── Publish sdist + wheel + bundles to GitHub Release ────────────────
+  release:
+    needs: bundle
+    runs-on: ubuntu-26.04
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.11"
+
+      - name: Upgrade pip + certifi
+        run: python -m pip install -U "pip>=26.2.2" "certifi>=2026.10.19"
+
+      - name: Build sdist + wheel
+        run: pip install hatch hatch-vcs && hatch build
+
+      - uses: actions/upload-artifact@v7
+        with:
+          name: python-dist
+          path: dist/
+
+      - uses: actions/download-artifact@v8
+        with:
+          path: bundles
+          merge-multiple: true
+
+      - uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            dist/*
+            bundles/*.zip
+
+  # ── Publish sdist + wheel to PyPI (trusted publishing, no token) ─────
+  pypi:
+    needs: release
+    runs-on: ubuntu-26.04
+    environment: pypi
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: python-dist
+          path: dist
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

bad_ass_mcp-1.4.0/.gitignore

@@ -0,0 +1,12 @@
+.cursor
+.claude
+.vscode
+.idea
+target
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.venv/

bad_ass_mcp-1.4.0/.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

bad_ass_mcp-1.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Michael Behan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bad_ass_mcp-1.4.0/PKG-INFO

@@ -0,0 +1,231 @@
+Metadata-Version: 2.5
+Name: bad-ass-mcp
+Version: 1.4.0
+Summary: Cross-platform desktop GUI automation MCP — accessibility tree first, vision as last resort
+Project-URL: Homepage, https://github.com/HoldMyBeer-gg/bad-ass-mcp
+Project-URL: Repository, https://github.com/HoldMyBeer-gg/bad-ass-mcp
+Project-URL: Issues, https://github.com/HoldMyBeer-gg/bad-ass-mcp/issues
+Project-URL: Changelog, https://github.com/HoldMyBeer-gg/bad-ass-mcp/releases
+Author: Michael Behan
+License-Expression: MIT
+License-File: LICENSE
+Keywords: a11y,accessibility,automation,claude,desktop,gui,mcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Desktop Environment
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.11
+Requires-Dist: mcp<2,>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.9; extra == 'dev'
+Provides-Extra: macos
+Requires-Dist: pyobjc-framework-applicationservices>=9.0; extra == 'macos'
+Requires-Dist: pyobjc-framework-cocoa>=9.0; extra == 'macos'
+Requires-Dist: pyobjc-framework-quartz>=9.0; extra == 'macos'
+Provides-Extra: windows
+Requires-Dist: comtypes>=1.4; extra == 'windows'
+Description-Content-Type: text/markdown
+
+# bad-ass-mcp
+
+*Every other tool needs a browser or a vision model. This one reads what the OS already knows.*
+
+A cross-platform MCP server for desktop GUI automation — driven by accessibility APIs, not screenshots.
+
+Works with Claude, Codex, Gemini, Ollama, or any OpenAI-compatible client that supports MCP.
+
+![bad-ass-mcp recording itself interacting with MarkTheCrab](https://raw.githubusercontent.com/HoldMyBeer-gg/bad-ass-mcp/main/docs/demo.gif)
+*bad-ass-mcp recording itself interacting with [MarkTheCrab](https://github.com/HoldMyBeer-gg/MarkTheCrab)*
+
+## Why
+
+Most AI desktop automation tools work by taking screenshots and asking a vision model "what do you see?" That's slow, expensive, and fragile.
+
+Every major OS exposes a structured accessibility tree — the same one used by screen readers — that describes every button, text field, combo box, and menu in every running application. **bad-ass-mcp** speaks that language directly.
+
+- **macOS**: AXUIElement via PyObjC
+- **Linux**: AT-SPI2 via `gi.repository.Atspi`
+- **Windows**: UI Automation via `comtypes`
+
+Actions fire on control objects directly, so the target window doesn't need focus. The user can keep working while automation runs in the background.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_windows` | List all visible application windows |
+| `get_tree` | Full accessibility tree for a window as nested JSON |
+| `find_elements` | Find elements by role and/or name |
+| `click` | Click / invoke an element (foreground-independent) |
+| `click_at` | Click at absolute screen coordinates — fallback for webview/canvas UI |
+| `type_text` | Type text into a field (SetValue → EditableText → key injection) |
+| `select_option` | Select an option in a combo box or list |
+| `get_value` | Get the current value or text of an element |
+| `wait_for_window` | Wait until a window matching a pattern appears |
+| `wait_for_element` | Wait until an element exists and optionally has a given state |
+| `screenshot` | Capture a PNG (write to `output_path` or return base64) |
+| `start_recording` | Start recording the screen (or a specific window) |
+| `stop_recording` | Stop recording and export as a GIF |
+| `learn_layout` | Resolve semantic names → live handle IDs (one call per session) |
+| `run_sequence` | Execute a list of actions server-side — no per-action round-trips |
+
+## Webviews: waking lazy accessibility trees
+
+Chromium-based apps (Electron, CEF, and every Chromium browser) have a
+full accessibility tree — they just don't *build* it until an assistive
+technology announces itself. Until then the window looks canvas-only:
+`get_tree` returns nothing and screenshot-clicking is the only option.
+
+**bad-ass-mcp announces itself.** When a window's a11y tree comes back
+empty and the process looks like a webview, the backend performs the
+platform's "a screen reader is here" handshake, waits a beat, and
+re-probes before giving up:
+
+- **Linux**: sets `org.a11y.Status.ScreenReaderEnabled` on the session
+  D-Bus **at server start** so Chromium/Electron apps launched
+  afterwards enable accessibility from birth. Windows that stay hollow
+  (an application+frame whose phantom child fetches as `None`) are
+  detected via the AT-SPI toolkit name and reported
+  `accessible: false`: the app either launched before the flag went up
+  or opts out on its own. Restarting the app with the server running
+  should pick the flag up per Chromium's documented behavior, but note
+  that is not yet verified here: the only Linux app live-tested so far
+  (flatpak Vivaldi) ignores the flag entirely, its own first-run
+  assistive-technology toggle included, and only produces a tree when
+  launched with `--force-renderer-accessibility`.
+- **macOS**: sets `AXManualAccessibility` on the app (Electron's
+  documented switch), falling back to `AXEnhancedUserInterface` (what
+  VoiceOver sets, watched by plain Chrome/CEF). The attribute set only
+  succeeds on apps that support it, so it's a free no-op elsewhere.
+- **Windows**: sets the system `SPI_SETSCREENREADERRUNNING` flag, then
+  queries the `Chrome_RenderWidgetHostHWND` child window — Chromium
+  hangs its DOM tree off that renderer child, not the top-level HWND
+  (which only shows empty panes). `get_tree` / `find_elements` are
+  routed through the renderer child automatically.
+
+One wake attempt per process per server run. If `list_windows` still
+reports `accessible: false` after this, the window is genuinely
+canvas-only (custom OpenGL/Vulkan surface, immediate-mode toolkit
+without AccessKit) — fall back to `screenshot` + `click_at`.
+
+The tradeoff: a woken app spends some memory/CPU maintaining its tree,
+which is exactly why Chromium lazy-loads it. The wake targets the app
+you're automating, not the whole desktop (the Linux flag is technically
+session-global, but only a11y-aware apps respond, and only on demand).
+
+## Installation
+
+**Requirements**: Python 3.11+, `ffmpeg` + `gifsicle` for recording (optional)
+
+```bash
+# macOS
+pip install 'bad-ass-mcp[macos]'
+
+# Linux — install system PyGObject + AT-SPI bindings first, then:
+pip install bad-ass-mcp
+
+# Windows
+pip install 'bad-ass-mcp[windows]'
+```
+
+**Linux**: PyGObject and AT-SPI are not on PyPI — install them from your distro:
+
+```bash
+# Debian/Ubuntu
+sudo apt install python3-gi gir1.2-atspi-2.0 at-spi2-core
+
+# Arch
+sudo pacman -S python-gobject at-spi2-core
+
+# Fedora
+sudo dnf install python3-gobject at-spi2-core
+```
+
+Then make sure AT-SPI is enabled (most desktop environments — GNOME, KDE, XFCE — have it on by default):
+
+```bash
+# Check
+gsettings get org.gnome.desktop.interface toolkit-accessibility
+
+# Enable
+gsettings set org.gnome.desktop.interface toolkit-accessibility true
+```
+
+If you're using a venv, create it with `--system-site-packages` so it can see the distro-installed `gi`:
+
+```bash
+python -m venv --system-site-packages venv
+```
+
+**Windows**: Elevated (admin) applications can only be automated from an elevated Python process. No special permissions are needed for normal apps.
+
+### Register with Claude Code
+
+```bash
+claude mcp add bad-ass-mcp --scope user -- bad-ass-mcp
+```
+
+Or manually in `~/.claude.json`:
+
+```json
+{
+  "mcpServers": {
+    "bad-ass-mcp": {
+      "type": "stdio",
+      "command": "bad-ass-mcp"
+    }
+  }
+}
+```
+
+## Usage
+
+```
+list the windows on screen
+→ [{ "id": "12345", "name": "Firefox", ... }]
+
+find the search box in window 12345 and type "hello"
+→ find_elements(window_id="12345", role="entry")
+→ type_text(handle_id="...", text="hello")
+```
+
+Electron/CEF apps get their lazy accessibility tree woken automatically (see [Webviews](#webviews-waking-lazy-accessibility-trees) above). For apps that still don't expose a clean tree, `type_text` falls back to platform-native key injection automatically (AT-SPI on Linux, Quartz events on macOS, `PostMessage` on Windows).
+
+## Architecture
+
+```
+bad_ass_mcp/
+├── server.py          # FastMCP tool definitions
+├── types.py           # WindowInfo, ElementHandle, ActionResult, StaleHandleError
+└── backend/
+    ├── base.py        # Abstract DesktopBackend interface
+    ├── linux.py       # AT-SPI2 + xdotool
+    ├── macos.py       # AXUIElement + Quartz
+    └── windows.py     # UI Automation + ctypes Win32
+```
+
+The abstract backend interface means adding a new platform is just implementing one class. The full contract-test suite runs against every backend via `FakeBackend`.
+
+## Releasing
+
+Tag a version and the release workflow builds the sdist and wheel, publishes them
+to PyPI via trusted publishing, and attaches them (plus the PyInstaller bundles)
+to the GitHub release:
+
+```bash
+git tag v1.4.0 && git push --tags
+```
+
+## License
+
+MIT

bad_ass_mcp-1.4.0/README.md

@@ -0,0 +1,193 @@
+# bad-ass-mcp
+
+*Every other tool needs a browser or a vision model. This one reads what the OS already knows.*
+
+A cross-platform MCP server for desktop GUI automation — driven by accessibility APIs, not screenshots.
+
+Works with Claude, Codex, Gemini, Ollama, or any OpenAI-compatible client that supports MCP.
+
+![bad-ass-mcp recording itself interacting with MarkTheCrab](https://raw.githubusercontent.com/HoldMyBeer-gg/bad-ass-mcp/main/docs/demo.gif)
+*bad-ass-mcp recording itself interacting with [MarkTheCrab](https://github.com/HoldMyBeer-gg/MarkTheCrab)*
+
+## Why
+
+Most AI desktop automation tools work by taking screenshots and asking a vision model "what do you see?" That's slow, expensive, and fragile.
+
+Every major OS exposes a structured accessibility tree — the same one used by screen readers — that describes every button, text field, combo box, and menu in every running application. **bad-ass-mcp** speaks that language directly.
+
+- **macOS**: AXUIElement via PyObjC
+- **Linux**: AT-SPI2 via `gi.repository.Atspi`
+- **Windows**: UI Automation via `comtypes`
+
+Actions fire on control objects directly, so the target window doesn't need focus. The user can keep working while automation runs in the background.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_windows` | List all visible application windows |
+| `get_tree` | Full accessibility tree for a window as nested JSON |
+| `find_elements` | Find elements by role and/or name |
+| `click` | Click / invoke an element (foreground-independent) |
+| `click_at` | Click at absolute screen coordinates — fallback for webview/canvas UI |
+| `type_text` | Type text into a field (SetValue → EditableText → key injection) |
+| `select_option` | Select an option in a combo box or list |
+| `get_value` | Get the current value or text of an element |
+| `wait_for_window` | Wait until a window matching a pattern appears |
+| `wait_for_element` | Wait until an element exists and optionally has a given state |
+| `screenshot` | Capture a PNG (write to `output_path` or return base64) |
+| `start_recording` | Start recording the screen (or a specific window) |
+| `stop_recording` | Stop recording and export as a GIF |
+| `learn_layout` | Resolve semantic names → live handle IDs (one call per session) |
+| `run_sequence` | Execute a list of actions server-side — no per-action round-trips |
+
+## Webviews: waking lazy accessibility trees
+
+Chromium-based apps (Electron, CEF, and every Chromium browser) have a
+full accessibility tree — they just don't *build* it until an assistive
+technology announces itself. Until then the window looks canvas-only:
+`get_tree` returns nothing and screenshot-clicking is the only option.
+
+**bad-ass-mcp announces itself.** When a window's a11y tree comes back
+empty and the process looks like a webview, the backend performs the
+platform's "a screen reader is here" handshake, waits a beat, and
+re-probes before giving up:
+
+- **Linux**: sets `org.a11y.Status.ScreenReaderEnabled` on the session
+  D-Bus **at server start** so Chromium/Electron apps launched
+  afterwards enable accessibility from birth. Windows that stay hollow
+  (an application+frame whose phantom child fetches as `None`) are
+  detected via the AT-SPI toolkit name and reported
+  `accessible: false`: the app either launched before the flag went up
+  or opts out on its own. Restarting the app with the server running
+  should pick the flag up per Chromium's documented behavior, but note
+  that is not yet verified here: the only Linux app live-tested so far
+  (flatpak Vivaldi) ignores the flag entirely, its own first-run
+  assistive-technology toggle included, and only produces a tree when
+  launched with `--force-renderer-accessibility`.
+- **macOS**: sets `AXManualAccessibility` on the app (Electron's
+  documented switch), falling back to `AXEnhancedUserInterface` (what
+  VoiceOver sets, watched by plain Chrome/CEF). The attribute set only
+  succeeds on apps that support it, so it's a free no-op elsewhere.
+- **Windows**: sets the system `SPI_SETSCREENREADERRUNNING` flag, then
+  queries the `Chrome_RenderWidgetHostHWND` child window — Chromium
+  hangs its DOM tree off that renderer child, not the top-level HWND
+  (which only shows empty panes). `get_tree` / `find_elements` are
+  routed through the renderer child automatically.
+
+One wake attempt per process per server run. If `list_windows` still
+reports `accessible: false` after this, the window is genuinely
+canvas-only (custom OpenGL/Vulkan surface, immediate-mode toolkit
+without AccessKit) — fall back to `screenshot` + `click_at`.
+
+The tradeoff: a woken app spends some memory/CPU maintaining its tree,
+which is exactly why Chromium lazy-loads it. The wake targets the app
+you're automating, not the whole desktop (the Linux flag is technically
+session-global, but only a11y-aware apps respond, and only on demand).
+
+## Installation
+
+**Requirements**: Python 3.11+, `ffmpeg` + `gifsicle` for recording (optional)
+
+```bash
+# macOS
+pip install 'bad-ass-mcp[macos]'
+
+# Linux — install system PyGObject + AT-SPI bindings first, then:
+pip install bad-ass-mcp
+
+# Windows
+pip install 'bad-ass-mcp[windows]'
+```
+
+**Linux**: PyGObject and AT-SPI are not on PyPI — install them from your distro:
+
+```bash
+# Debian/Ubuntu
+sudo apt install python3-gi gir1.2-atspi-2.0 at-spi2-core
+
+# Arch
+sudo pacman -S python-gobject at-spi2-core
+
+# Fedora
+sudo dnf install python3-gobject at-spi2-core
+```
+
+Then make sure AT-SPI is enabled (most desktop environments — GNOME, KDE, XFCE — have it on by default):
+
+```bash
+# Check
+gsettings get org.gnome.desktop.interface toolkit-accessibility
+
+# Enable
+gsettings set org.gnome.desktop.interface toolkit-accessibility true
+```
+
+If you're using a venv, create it with `--system-site-packages` so it can see the distro-installed `gi`:
+
+```bash
+python -m venv --system-site-packages venv
+```
+
+**Windows**: Elevated (admin) applications can only be automated from an elevated Python process. No special permissions are needed for normal apps.
+
+### Register with Claude Code
+
+```bash
+claude mcp add bad-ass-mcp --scope user -- bad-ass-mcp
+```
+
+Or manually in `~/.claude.json`:
+
+```json
+{
+  "mcpServers": {
+    "bad-ass-mcp": {
+      "type": "stdio",
+      "command": "bad-ass-mcp"
+    }
+  }
+}
+```
+
+## Usage
+
+```
+list the windows on screen
+→ [{ "id": "12345", "name": "Firefox", ... }]
+
+find the search box in window 12345 and type "hello"
+→ find_elements(window_id="12345", role="entry")
+→ type_text(handle_id="...", text="hello")
+```
+
+Electron/CEF apps get their lazy accessibility tree woken automatically (see [Webviews](#webviews-waking-lazy-accessibility-trees) above). For apps that still don't expose a clean tree, `type_text` falls back to platform-native key injection automatically (AT-SPI on Linux, Quartz events on macOS, `PostMessage` on Windows).
+
+## Architecture
+
+```
+bad_ass_mcp/
+├── server.py          # FastMCP tool definitions
+├── types.py           # WindowInfo, ElementHandle, ActionResult, StaleHandleError
+└── backend/
+    ├── base.py        # Abstract DesktopBackend interface
+    ├── linux.py       # AT-SPI2 + xdotool
+    ├── macos.py       # AXUIElement + Quartz
+    └── windows.py     # UI Automation + ctypes Win32
+```
+
+The abstract backend interface means adding a new platform is just implementing one class. The full contract-test suite runs against every backend via `FakeBackend`.
+
+## Releasing
+
+Tag a version and the release workflow builds the sdist and wheel, publishes them
+to PyPI via trusted publishing, and attaches them (plus the PyInstaller bundles)
+to the GitHub release:
+
+```bash
+git tag v1.4.0 && git push --tags
+```
+
+## License
+
+MIT

bad_ass_mcp-1.4.0/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[project]
+name = "bad-ass-mcp"
+dynamic = ["version"]
+description = "Cross-platform desktop GUI automation MCP — accessibility tree first, vision as last resort"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Michael Behan" }]
+keywords = ["mcp", "accessibility", "automation", "desktop", "gui", "a11y", "claude"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: MacOS",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Testing",
+    "Topic :: Desktop Environment",
+]
+requires-python = ">=3.11"
+dependencies = [
+    "mcp>=1.0.0,<2",
+]
+
+[project.optional-dependencies]
+macos = ["pyobjc-framework-Cocoa>=9.0", "pyobjc-framework-ApplicationServices>=9.0", "pyobjc-framework-Quartz>=9.0"]
+windows = ["comtypes>=1.4"]
+dev = ["pytest>=8.0", "pytest-asyncio>=0.23", "ruff>=0.9"]
+
+[project.urls]
+Homepage = "https://github.com/HoldMyBeer-gg/bad-ass-mcp"
+Repository = "https://github.com/HoldMyBeer-gg/bad-ass-mcp"
+Issues = "https://github.com/HoldMyBeer-gg/bad-ass-mcp/issues"
+Changelog = "https://github.com/HoldMyBeer-gg/bad-ass-mcp/releases"
+
+[project.scripts]
+bad-ass-mcp = "bad_ass_mcp.server:main"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.ruff]
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "I"]