crosspad-mcp-server 4.0.0

package/README.md

@@ -0,0 +1,187 @@
+# crosspad-mcp
+
+MCP (Model Context Protocol) server that gives Claude Code full control over the CrossPad development workflow — build, test, run, screenshot, interact with the simulator, search code across all repos, and manage settings. All from natural language.
+
+## What it does
+
+Instead of manually running cmake, launching the simulator, grepping through 5 repos, and checking submodule state — Claude does it through 17 specialized tools:
+
+**Build & Run** — build the simulator (incremental/clean/reconfigure), launch it, check build health, capture startup logs.
+
+**Testing** — run Catch2 tests with filtering, scaffold test infrastructure from scratch.
+
+**Code navigation** — search symbols (classes, functions, macros, enums) across all CrossPad repos at once. Query interfaces and their platform implementations. List registered apps.
+
+**Simulator interaction** — take screenshots (full window or LCD-only), press pads, rotate the encoder, click UI elements, read runtime stats (pad state, capabilities, heap), read/write settings — all while the simulator is running.
+
+**Multi-repo awareness** — git status across all 5 CrossPad repos, detect dev-mode vs submodule-mode, diff crosspad-core/gui against pinned commits.
+
+**Real-time streaming** — build output, test results, and log capture stream line-by-line to Claude instead of blocking until completion.
+
+## Prerequisites
+
+- **Node.js** 18+
+- **crosspad-pc** repo cloned and buildable (cmake, vcpkg, SDL2)
+- **Windows**: Visual Studio 2022 (MSVC) — auto-detected
+- **macOS/Linux**: clang or gcc, cmake, ninja (optional)
+
+## Installation
+
+```bash
+git clone https://github.com/CrossPad/crosspad-mcp.git
+cd crosspad-mcp
+npm install
+npm run build
+```
+
+### Configure Claude Code
+
+Add to your Claude Code MCP settings (`.claude/settings.local.json` in the crosspad-pc project, or global `~/.claude/settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "crosspad": {
+      "command": "node",
+      "args": ["C:/Users/YourName/GIT/crosspad-mcp/dist/index.js"],
+      "env": {}
+    }
+  }
+}
+```
+
+Restart Claude Code after adding the config.
+
+### Configure for VS Code (Copilot / Cline / etc.)
+
+Add to `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "crosspad": {
+      "command": "node",
+      "args": ["C:/Users/YourName/GIT/crosspad-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+## Configuration
+
+All paths are configurable via environment variables. Defaults work out of the box on the main dev machine (Windows). On Mac/Linux, set these in your MCP server config `env` block:
+
+| Variable | Default (Windows) | Default (Mac/Linux) | Description |
+|---|---|---|---|
+| `CROSSPAD_GIT_DIR` | `C:/Users/Mateusz/GIT` | `~/GIT` | Base directory containing all CrossPad repos |
+| `CROSSPAD_PC_ROOT` | `$GIT_DIR/crosspad-pc` | `$GIT_DIR/crosspad-pc` | Path to crosspad-pc repo |
+| `VCPKG_ROOT` | `C:/vcpkg` | `~/vcpkg` | vcpkg installation directory |
+| `CMAKE_GENERATOR` | `Ninja` | system default | CMake generator (`Ninja`, `Unix Makefiles`, etc.) |
+| `VCVARSALL` | VS2022 Community path | *(not used)* | MSVC vcvarsall.bat path (Windows only) |
+
+Example for macOS:
+
+```json
+{
+  "mcpServers": {
+    "crosspad": {
+      "command": "node",
+      "args": ["/Users/you/GIT/crosspad-mcp/dist/index.js"],
+      "env": {
+        "CROSSPAD_GIT_DIR": "/Users/you/GIT",
+        "VCPKG_ROOT": "/opt/vcpkg"
+      }
+    }
+  }
+}
+```
+
+## Tools reference
+
+### Build & Run
+
+| Tool | Description |
+|---|---|
+| `crosspad_build` | Build the simulator. Modes: `incremental` (default), `clean` (wipe + rebuild), `reconfigure` (cmake configure + build — use after adding new source files) |
+| `crosspad_run` | Launch `bin/main.exe`. Returns PID immediately |
+| `crosspad_build_check` | Health check: stale exe? new source files needing reconfigure? submodule drift? dirty working trees? |
+| `crosspad_log` | Launch the exe, capture stdout/stderr for N seconds, then kill it. Great for checking init, crashes, runtime errors |
+
+### Testing
+
+| Tool | Description |
+|---|---|
+| `crosspad_test` | Build and run the Catch2 test suite. Supports name filtering (`[core]`, `PadManager`) and `list_only` mode |
+| `crosspad_test_scaffold` | Generate test infrastructure (CMakeLists.txt + sample test). Returns file contents — does NOT write to disk |
+
+### Multi-repo
+
+| Tool | Description |
+|---|---|
+| `crosspad_repos_status` | Git status across all 5 CrossPad repos. Detects dev-mode (junction/symlink) vs submodule-mode |
+| `crosspad_diff_core` | What changed in crosspad-core/gui vs the pinned submodule commit. Commits ahead/behind, changed files, uncommitted changes |
+
+### Code & Architecture
+
+| Tool | Description |
+|---|---|
+| `crosspad_search_symbols` | Find classes, functions, macros, enums across all repos. Filters by kind and repo. Uses `git grep` |
+| `crosspad_scaffold_app` | Generate boilerplate for a new CrossPad app (cpp, hpp, CMakeLists.txt, optional pad logic handler) |
+| `crosspad_interfaces` | Query crosspad-core interfaces: `list` all, `implementations <Name>`, or `capabilities` flags |
+| `crosspad_apps` | List registered apps per platform (`pc`, `esp32`, `2player`, `all`) |
+
+### Simulator interaction
+
+These tools require the simulator to be running (`crosspad_run` first).
+
+| Tool | Description |
+|---|---|
+| `crosspad_screenshot` | Capture PNG screenshot. `region`: `full` (490x680 window) or `lcd` (320x240 screen only). Save to file or return base64 |
+| `crosspad_input` | Send events: `click` {x,y}, `pad_press` {pad,velocity}, `pad_release`, `encoder_rotate` {delta}, `encoder_press`/`release`, `key` {keycode} |
+| `crosspad_stats` | Runtime diagnostics: pad state (16 pads), capabilities, registered apps, heap usage, settings snapshot |
+| `crosspad_settings` | Read settings by category or write individual keys. Auto-saves to `~/.crosspad/preferences.json` |
+
+## Architecture
+
+```
+src/
+  index.ts              — MCP server, tool registrations, streaming logger
+  config.ts             — platform-aware paths (env vars, OS detection)
+  utils/
+    exec.ts             — runBuild/runBuildStream (MSVC on Windows, default shell on Unix)
+    git.ts              — getRepoStatus(), getSubmodulePin(), getHead()
+    remote-client.ts    — TCP client for simulator remote control (localhost:19840)
+  tools/
+    build.ts            — crosspad_build, crosspad_run
+    build-check.ts      — crosspad_build_check
+    log.ts              — crosspad_log
+    test.ts             — crosspad_test, crosspad_test_scaffold
+    repos.ts            — crosspad_repos_status
+    diff-core.ts        — crosspad_diff_core
+    symbols.ts          — crosspad_search_symbols
+    scaffold.ts         — crosspad_scaffold_app
+    architecture.ts     — crosspad_interfaces, crosspad_apps
+    screenshot.ts       — crosspad_screenshot
+    input.ts            — crosspad_input
+    stats.ts            — crosspad_stats
+    settings.ts         — crosspad_settings
+```
+
+**Static tools** (build, repos, symbols, scaffold) work without the simulator running — they operate on the filesystem and git.
+
+**Interactive tools** (screenshot, input, stats, settings) communicate with the simulator via TCP on `localhost:19840`. The simulator includes a built-in remote control server that accepts newline-delimited JSON commands.
+
+**Streaming** — long-running tools (build, test, log) emit output line-by-line via MCP logging notifications instead of blocking. Claude sees the output in real-time.
+
+## Development
+
+```bash
+npm run dev    # watch mode — recompiles on save
+npm run build  # one-shot build
+```
+
+After rebuilding, restart Claude Code to pick up the new server binary.
+
+## License
+
+Part of the [CrossPad](https://github.com/CrossPad) project. Open source.

package/dist/config.d.ts

@@ -0,0 +1,10 @@
+export declare const IS_WINDOWS: boolean;
+export declare const IS_MAC: boolean;
+export declare const CROSSPAD_PC_ROOT: string;
+export declare const REPOS: Record<string, string>;
+export declare const VCVARSALL: string;
+export declare const VCPKG_TOOLCHAIN: string;
+export declare const BUILD_DIR: string;
+export declare const BIN_EXE: string;
+export declare const CROSSPAD_IDF_ROOT: string;
+export declare const IDF_PATH: string;

package/dist/config.js

@@ -0,0 +1,33 @@
+import path from "path";
+import os from "os";
+export const IS_WINDOWS = process.platform === "win32";
+export const IS_MAC = process.platform === "darwin";
+// Base directory for all CrossPad repos (override with CROSSPAD_GIT_DIR)
+const defaultGitDir = IS_WINDOWS
+    ? "C:/Users/Mateusz/GIT"
+    : path.join(os.homedir(), "GIT");
+const GIT_DIR = process.env.CROSSPAD_GIT_DIR || defaultGitDir;
+export const CROSSPAD_PC_ROOT = process.env.CROSSPAD_PC_ROOT || path.join(GIT_DIR, "crosspad-pc");
+export const REPOS = {
+    "crosspad-core": path.join(GIT_DIR, "crosspad-core"),
+    "crosspad-gui": path.join(GIT_DIR, "crosspad-gui"),
+    "crosspad-pc": CROSSPAD_PC_ROOT,
+    "ESP32-S3": path.join(GIT_DIR, "ESP32-S3"),
+    "2playerCrosspad": path.join(GIT_DIR, "P4_TEST", "2playerCrosspad"),
+    "crosspad-idf": path.join(GIT_DIR, "crosspad-idf"),
+};
+// MSVC — only used on Windows
+export const VCVARSALL = process.env.VCVARSALL ||
+    "C:\\Program Files\\Microsoft Visual Studio\\2022\\Community\\VC\\Auxiliary\\Build\\vcvarsall.bat";
+// vcpkg — platform-aware defaults
+const defaultVcpkgRoot = IS_WINDOWS ? "C:/vcpkg" : path.join(os.homedir(), "vcpkg");
+const vcpkgRoot = process.env.VCPKG_ROOT || defaultVcpkgRoot;
+export const VCPKG_TOOLCHAIN = path.join(vcpkgRoot, "scripts", "buildsystems", "vcpkg.cmake");
+export const BUILD_DIR = path.join(CROSSPAD_PC_ROOT, "build");
+const EXE_EXT = IS_WINDOWS ? ".exe" : "";
+export const BIN_EXE = path.join(CROSSPAD_PC_ROOT, "bin", `CrossPad${EXE_EXT}`);
+// ESP-IDF
+export const CROSSPAD_IDF_ROOT = process.env.CROSSPAD_IDF_ROOT || path.join(GIT_DIR, "crosspad-idf");
+const defaultIdfPath = path.join(os.homedir(), "esp", "v5.5", "esp-idf");
+export const IDF_PATH = process.env.IDF_PATH || defaultIdfPath;
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;AACvD,MAAM,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC;AAEpD,yEAAyE;AACzE,MAAM,aAAa,GAAG,UAAU;IAC9B,CAAC,CAAC,sBAAsB;IACxB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;AACnC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,aAAa,CAAC;AAE9D,MAAM,CAAC,MAAM,gBAAgB,GAC3B,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AAEpE,MAAM,CAAC,MAAM,KAAK,GAA2B;IAC3C,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC;IACpD,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC;IAClD,aAAa,EAAE,gBAAgB;IAC/B,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;IAC1C,iBAAiB,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,iBAAiB,CAAC;IACnE,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC;CACnD,CAAC;AAEF,8BAA8B;AAC9B,MAAM,CAAC,MAAM,SAAS,GACpB,OAAO,CAAC,GAAG,CAAC,SAAS;IACrB,kGAAkG,CAAC;AAErG,kCAAkC;AAClC,MAAM,gBAAgB,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AACpF,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,gBAAgB,CAAC;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;AAE9F,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;AAE9D,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AACzC,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,KAAK,EAAE,WAAW,OAAO,EAAE,CAAC,CAAC;AAEhF,UAAU;AACV,MAAM,CAAC,MAAM,iBAAiB,GAC5B,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;AAEtE,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,cAAc,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,360 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { crosspadBuild, crosspadRun } from "./tools/build.js";
+import { crosspadReposStatus } from "./tools/repos.js";
+import { crosspadScaffoldApp } from "./tools/scaffold.js";
+import { crosspadInterfaces, crosspadApps } from "./tools/architecture.js";
+import { crosspadBuildCheck } from "./tools/build-check.js";
+import { crosspadSearchSymbols } from "./tools/symbols.js";
+import { crosspadDiffCore } from "./tools/diff-core.js";
+import { crosspadLog } from "./tools/log.js";
+import { crosspadTest, crosspadTestScaffold } from "./tools/test.js";
+import { crosspadScreenshot } from "./tools/screenshot.js";
+import { crosspadInput } from "./tools/input.js";
+import { crosspadSettingsGet, crosspadSettingsSet } from "./tools/settings.js";
+import { crosspadStats } from "./tools/stats.js";
+import { crosspadIdfBuild } from "./tools/idf-build.js";
+const server = new McpServer({
+    name: "crosspad",
+    version: "4.0.0",
+}, {
+    capabilities: {
+        logging: {},
+    },
+});
+/**
+ * Create an OnLine callback that streams each line to the MCP client
+ * via logging notifications. Build output is "info", errors are "error".
+ */
+function makeStreamLogger(logger) {
+    return (stream, line) => {
+        if (!line.trim())
+            return; // skip empty lines
+        const level = stream === "stderr" ? "warning" : "info";
+        server.server.sendLoggingMessage({ level, logger, data: line }).catch(() => { });
+    };
+}
+// ═══════════════════════════════════════════════════════════════════════
+// BUILD & RUN
+// ═══════════════════════════════════════════════════════════════════════
+server.tool("crosspad_build", "Build crosspad-pc simulator (incremental, clean, or reconfigure)", {
+    mode: z
+        .enum(["incremental", "clean", "reconfigure"])
+        .default("incremental")
+        .describe("incremental: just cmake --build. clean: delete build dir + full rebuild. reconfigure: cmake configure + build (use after adding new source files)"),
+}, async ({ mode }) => {
+    const onLine = makeStreamLogger("build");
+    const result = await crosspadBuild(mode, onLine);
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("crosspad_run", "Launch the crosspad-pc simulator (bin/CrossPad.exe). Returns immediately with PID.", {}, async () => {
+    const result = crosspadRun();
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("crosspad_build_check", "Quick health check: is the build up to date? Detects stale exe, new source files needing reconfigure, submodule drift, dirty working trees. Use before build to know what mode to use.", {}, async () => {
+    const result = crosspadBuildCheck();
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("crosspad_log", "Launch CrossPad.exe, capture stdout/stderr for a few seconds, then kill it. Great for checking init sequence, crash messages, or runtime errors without leaving the process running.", {
+    timeout_seconds: z
+        .number()
+        .default(5)
+        .describe("How long to let the process run before killing it (default: 5)"),
+    max_lines: z
+        .number()
+        .default(200)
+        .describe("Max lines of output to return (default: 200)"),
+}, async ({ timeout_seconds, max_lines }) => {
+    const onLine = makeStreamLogger("log");
+    const result = await crosspadLog(timeout_seconds, max_lines, onLine);
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+// ═══════════════════════════════════════════════════════════════════════
+// ESP-IDF BUILD
+// ═══════════════════════════════════════════════════════════════════════
+server.tool("crosspad_idf_build", "Build the crosspad-idf ESP32-S3 firmware using idf.py. Use fullclean after adding new app directories or CMakeLists.txt changes.", {
+    mode: z
+        .enum(["build", "fullclean", "clean"])
+        .default("build")
+        .describe("build: incremental idf.py build. fullclean: idf.py fullclean + build (required after new app dirs). clean: delete build/ + build."),
+}, async ({ mode }) => {
+    const onLine = makeStreamLogger("idf-build");
+    const result = await crosspadIdfBuild(mode, onLine);
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+// ═══════════════════════════════════════════════════════════════════════
+// TEST
+// ═══════════════════════════════════════════════════════════════════════
+server.tool("crosspad_test", "Build and run the Catch2 test suite. If no tests/ dir exists, tells you to scaffold. Supports filtering by test name.", {
+    filter: z
+        .string()
+        .default("")
+        .describe("Catch2 test name filter (e.g. '[core]' or 'PadManager')"),
+    list_only: z
+        .boolean()
+        .default(false)
+        .describe("Just list available tests without running them"),
+}, async ({ filter, list_only }) => {
+    const onLine = makeStreamLogger("test");
+    const result = await crosspadTest(filter, list_only, onLine);
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("crosspad_test_scaffold", "Generate test infrastructure: tests/CMakeLists.txt (Catch2 v3), sample test file, and CMake patch instructions. Returns file contents — does NOT write to disk.", {}, async () => {
+    const result = crosspadTestScaffold();
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+// ═══════════════════════════════════════════════════════════════════════
+// REPOS & SUBMODULES
+// ═══════════════════════════════════════════════════════════════════════
+server.tool("crosspad_repos_status", "Show git status across all CrossPad repos (crosspad-core, crosspad-gui, crosspad-pc, ESP32-S3, 2playerCrosspad). Detects dev-mode vs submodule-mode and checks submodule pin sync.", {}, async () => {
+    const result = crosspadReposStatus();
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("crosspad_diff_core", "Show what changed in crosspad-core and/or crosspad-gui relative to the pinned submodule commit. Shows commits ahead/behind, changed files, uncommitted changes. Essential for dev-mode workflows.", {
+    submodule: z
+        .enum(["crosspad-core", "crosspad-gui", "both"])
+        .default("both")
+        .describe("Which submodule(s) to diff"),
+}, async ({ submodule }) => {
+    const result = crosspadDiffCore(submodule);
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+// ═══════════════════════════════════════════════════════════════════════
+// CODE & ARCHITECTURE
+// ═══════════════════════════════════════════════════════════════════════
+server.tool("crosspad_search_symbols", "Search for classes, functions, macros, enums across all CrossPad repos. Faster than manual grep — uses git grep under the hood.", {
+    query: z.string().describe("Symbol name or substring to search for"),
+    kind: z
+        .enum(["class", "function", "macro", "enum", "typedef", "all"])
+        .default("all")
+        .describe("Filter by symbol kind"),
+    repos: z
+        .array(z.string())
+        .default(["all"])
+        .describe('Repo names to search: "crosspad-core", "crosspad-pc", "ESP32-S3", etc. or ["all"]'),
+    max_results: z
+        .number()
+        .default(50)
+        .describe("Max results to return"),
+}, async ({ query, kind, repos, max_results }) => {
+    const result = crosspadSearchSymbols(query, kind, repos, max_results);
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("crosspad_scaffold_app", "Generate boilerplate for a new CrossPad app (cpp, hpp, CMakeLists.txt, optional pad logic). Returns file contents for Claude to write — does NOT create files on disk.", {
+    name: z
+        .string()
+        .describe("PascalCase app name, e.g. 'Metronome'"),
+    display_name: z
+        .string()
+        .optional()
+        .describe("Human-readable name (defaults to name)"),
+    has_pad_logic: z
+        .boolean()
+        .default(false)
+        .describe("Generate IPadLogicHandler stub"),
+    icon: z
+        .string()
+        .default("CrossPad_Logo_110w.png")
+        .describe("Icon filename"),
+}, async ({ name, display_name, has_pad_logic, icon }) => {
+    const result = crosspadScaffoldApp({
+        name,
+        display_name,
+        has_pad_logic,
+        icon,
+    });
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("crosspad_interfaces", 'Query crosspad-core interfaces and their implementations across all platforms. Use query="list" to list all interfaces, "implementations <InterfaceName>" to find implementations, or "capabilities" to show platform capability flags.', {
+    query: z
+        .string()
+        .describe('"list", "implementations <InterfaceName>", or "capabilities"'),
+}, async ({ query }) => {
+    const result = crosspadInterfaces(query);
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("crosspad_apps", "List all registered CrossPad apps (found via REGISTER_APP macro or _register_*_app functions).", {
+    platform: z
+        .enum(["pc", "esp32", "2player", "all"])
+        .default("pc")
+        .describe("Which platform to scan"),
+}, async ({ platform }) => {
+    const result = crosspadApps(platform);
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+// ═══════════════════════════════════════════════════════════════════════
+// SIMULATOR INTERACTION (requires running simulator with remote control)
+// ═══════════════════════════════════════════════════════════════════════
+server.tool("crosspad_screenshot", "Capture a screenshot from the running CrossPad simulator. Saves PNG to screenshots/ dir by default. Requires the simulator to be running (use crosspad_run first).", {
+    save_to_file: z
+        .boolean()
+        .default(true)
+        .describe("Save to disk (default: true). If false, returns base64 data inline."),
+    filename: z
+        .string()
+        .optional()
+        .describe("Custom filename (default: screenshot_<timestamp>.png)"),
+    region: z
+        .enum(["full", "lcd"])
+        .default("full")
+        .describe("full: entire simulator window (490x680). lcd: LCD screen only (320x240)."),
+}, async ({ save_to_file, filename, region }) => {
+    const result = await crosspadScreenshot(save_to_file, filename, region);
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("crosspad_input", `Send input events to the running CrossPad simulator. Requires simulator to be running.
+
+Actions:
+  click {x, y}           — mouse click at window coordinates (490x680 window)
+  pad_press {pad, vel}    — press pad 0-15 with velocity 0-127
+  pad_release {pad}       — release pad 0-15
+  encoder_rotate {delta}  — rotate encoder (positive=CW, negative=CCW)
+  encoder_press           — press encoder button
+  encoder_release         — release encoder button
+  key {keycode}           — SDL keycode (e.g. 13=Enter, 27=Escape)
+
+LCD area is centered at roughly x=85..405, y=20..260 within the 490x680 window.`, {
+    action: z
+        .enum(["click", "pad_press", "pad_release", "encoder_rotate", "encoder_press", "encoder_release", "key"])
+        .describe("Input action type"),
+    x: z.number().optional().describe("X coordinate for click"),
+    y: z.number().optional().describe("Y coordinate for click"),
+    pad: z.number().optional().describe("Pad index 0-15 for pad_press/pad_release"),
+    velocity: z.number().optional().describe("Velocity 0-127 for pad_press (default: 127)"),
+    delta: z.number().optional().describe("Rotation delta for encoder_rotate"),
+    keycode: z.number().optional().describe("SDL keycode for key action"),
+}, async ({ action, x, y, pad, velocity, delta, keycode }) => {
+    let input;
+    switch (action) {
+        case "click":
+            input = { action: "click", x: x ?? 0, y: y ?? 0 };
+            break;
+        case "pad_press":
+            input = { action: "pad_press", pad: pad ?? 0, velocity: velocity ?? 127 };
+            break;
+        case "pad_release":
+            input = { action: "pad_release", pad: pad ?? 0 };
+            break;
+        case "encoder_rotate":
+            input = { action: "encoder_rotate", delta: delta ?? 1 };
+            break;
+        case "encoder_press":
+            input = { action: "encoder_press" };
+            break;
+        case "encoder_release":
+            input = { action: "encoder_release" };
+            break;
+        case "key":
+            input = { action: "key", keycode: keycode ?? 0 };
+            break;
+        default:
+            return {
+                content: [{ type: "text", text: JSON.stringify({ success: false, error: "Unknown action" }) }],
+            };
+    }
+    const result = await crosspadInput(input);
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("crosspad_stats", `Query runtime statistics from the running simulator. Returns:
+- Platform capabilities (active flags)
+- Pad state (16 pads: pressed, playing, note, channel, RGB color)
+- Active/registered pad logic handlers
+- Registered apps list
+- Heap stats (SRAM/PSRAM free/total)
+- Settings summary (brightness, theme, kit, audio engine)`, {}, async () => {
+    const result = await crosspadStats();
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool("crosspad_settings", `Read or write CrossPad settings on the running simulator.
+
+Read: action="get", category="all"|"display"|"keypad"|"vibration"|"wireless"|"audio"|"system"
+Write: action="set", key="<setting_key>", value=<number> (booleans: 0/1)
+
+Writable keys:
+  lcd_brightness (0-255), rgb_brightness (0-255), theme_color (0-255), perf_stats_flags (bitmask)
+  kit (0-255), audio_engine (0/1)
+  keypad.enable, keypad.inactive_lights, keypad.eco_mode, keypad.send_stm/ble/usb/cc (0/1)
+  vibration.enable, vibration.on_touch, vibration.in_min/max, vibration.out_min/max (0-255)
+  master_fx.mute (0/1), master_fx.in_volume, master_fx.out_volume (0-100)
+
+Changes are auto-saved to ~/.crosspad/preferences.json.`, {
+    action: z
+        .enum(["get", "set"])
+        .describe("Read or write settings"),
+    category: z
+        .string()
+        .default("all")
+        .describe("For get: all, display, keypad, vibration, wireless, audio, system"),
+    key: z
+        .string()
+        .optional()
+        .describe("For set: dotted key name (e.g. 'lcd_brightness', 'keypad.eco_mode')"),
+    value: z
+        .number()
+        .optional()
+        .describe("For set: numeric value (booleans: 0=false, 1=true)"),
+}, async ({ action, category, key, value }) => {
+    if (action === "get") {
+        const result = await crosspadSettingsGet(category);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    else {
+        if (!key || value === undefined) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ success: false, error: "key and value required for set" }) }],
+            };
+        }
+        const result = await crosspadSettingsSet(key, value);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }
+});
+// ═══════════════════════════════════════════════════════════════════════
+// START
+// ═══════════════════════════════════════════════════════════════════════
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("MCP server failed:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/architecture.d.ts

@@ -0,0 +1,16 @@
+export interface InterfaceInfo {
+    name: string;
+    file: string;
+}
+export interface ImplementationInfo {
+    className: string;
+    file: string;
+    platform: string;
+}
+export declare function crosspadInterfaces(query: string): Record<string, unknown>;
+export interface AppInfo {
+    name: string;
+    registration_file: string;
+    platform: string;
+}
+export declare function crosspadApps(platform: "pc" | "esp32" | "2player" | "all"): AppInfo[];