NALA-MCP-cORe

<p align="center"> <img src="macOS/Sources/NALAMCPcOReApp/Resources/AppIcon.png" alt="NALA MCP cORe Icon" width="128" height="128"> </p> <h1 align="center">NALA-MCP-cORe</h1> <p align="center"> <strong>Native macOS & Windows Control Center for local-only MCP memory and SQLite database vaults.</strong> </p> <p align="center"> <a href="README.de.md">Deutsch</a> • <a href="README.fr.md">Français</a> • <a href="README.it.md">Italiano</a> </p> --- ## 🚀 Easy Download & Installation (For End Users) You do **NOT** need to compile this app or write code to use it! 1. Go to the **[Releases](https://github.com/Master-MD/NALA-MCP-cORe/releases)** section on the right side of this GitHub page. 2. Download the package for your operating system: - **macOS:** Download the `.dmg` file (supports both Apple Silicon/ARM and Intel Macs). - **Windows:** Download the `.zip` or `.exe` file (supports both Intel/AMD x64 and ARM64). 3. Open the downloaded file, drag & drop (macOS) or extract and run the `.exe` (Windows), and choose your local vault folder. --- ## 💡 What It Does & The Idea Behind It **NALA-MCP-cORe** is a local-only central vault that acts as the "brain" or memory core for AI clients like Codex, Gemini CLI, Google Antigravity, and future NALA workflows. It stores project memories, decisions, bug reports, and sessions securely in a local SQLite vault. ### Core Features: - **Zero-Cloud & 100% Local:** Your data never leaves your computer. No accounts, no APIs, no server keys required. - **Cross-Platform:** Native macOS app written in SwiftUI & Native Windows app written in C#/WPF. - **Smart FTS5 Indexing:** Ultra-fast context searching using SQLite full-text search. - **JSONL Event Journal:** An append-only log of all events for complete transparency and future audit trails. - **v0.2 Foundation:** Separate v0.2 vault, local NALA App Registry discovery, READ_ONLY 3D ModelManager bridge intake, automatic local DB change snapshots, and an Operator Lab dry-run report for safe next-step planning. - **Auto-i18n:** Detects your operating system's language automatically (English, German, French, Italian). - **Unknown Client Blocking:** Rejects connections and modifications from unrecognized tools. --- ## 📸 In-App Screenshots ### macOS App *Native macOS Control Center im Dark Mode – Dashboard mit Vault Status, Server, FTS5 Index, CPU/RAM Monitoring und Deep Stats.* <p align="center"> <img src="docs/screenshots/macos-dashboard.png" alt="NALA-MCP-cORe macOS Dashboard" width="700"> </p> ### Windows App *Natives WPF-Dashboard unter Windows 11 – Systemstatus, Tresor-Verwaltung und Echtzeit-Protokolle (automatisch auf Deutsch bei deutschem System).* <p align="center"> <img src="docs/screenshots/windows-dashboard.png" alt="NALA-MCP-cORe Windows Dashboard" width="700"> </p> --- ## ❓ FAQ (Frequently Asked Questions) ### Q: Where is my data stored? Your data is stored completely locally in a folder you choose during the first launch. macOS v0.2 defaults to `~/Library/Application Support/NALA-MCP-cORe-v0.2/`; the old v0.1 path `~/Library/Application Support/NALA-MCP-cORe/` is not overwritten automatically. ### Q: What is the NALA App Registry? It is a local-only folder at `~/Library/Application Support/NALA/AppRegistry/` where NALA apps can publish small localhost manifests. v0.2 reads direct JSON manifests and nested `*/manifest.json` files, starting with READ_ONLY NALA-3D-ModelManager discovery. ### Q: What can NALA-bRaiN do in v0.2? The macOS app has a NALA-bRaiN page for local/private health checks and sync-package export. It does not push vault data into NALA-bRaiN automatically. ### Q: What is Operator Lab? Operator Lab creates a local report-only dry-run before releases, upgrades, imports, or NALA-bRaiN work. It checks backups, database health, app registry, local-only guardrails, and proposes ranked next steps. It does not migrate v0.1, scan the network, push data, or run destructive tools. ### Q: Are automatic backups cloud backups? No. Automatic backups are local SQLite/event-journal change snapshots with manifests and checksums. They stay inside the local vault backup folder. ### Q: How do I upgrade from v0.1 to v0.2? Stop the old v0.1 app/helper and any MCP clients first. Start v0.2, open **Upgrade**, run **Inspect v0.1 Vault**, stop any listed helper processes, then **Run Safe Migration**. v0.2 creates a verified local backup of the v0.1 vault before importing objects into the new v0.2 vault. ### Q: Can I use it with cloud-synced folders? Yes! The Vault picker supports folders synced via iCloud Drive, Google Drive Desktop, Dropbox, or Synology Drive. ### Q: Why is my connection denied? By default, the core uses strict permission policies. Unknown clients or destructive tools are automatically blocked to keep your database safe. --- ## 🛠️ Monorepo Directory Structure This repository is structured as a Monorepo: - `/macOS`: Contains the native macOS SwiftUI app bundle and target files. - `/Windows`: Contains the native Windows C# WPF app. - `/.github/workflows`: Contains the automated CI/CD pipelines. --- ## 🏗️ Developer Section (How to Compile) ### macOS (Swift) ```bash cd macOS swift test ./script/build_and_run.sh --stable ``` ### Windows (.NET 8.0) ```cmd cd Windows dotnet build src/NALAMCPcOReWIN/NALAMCPcOReWIN.csproj -c Release dotnet run --project src/NALAMCPcOReWIN/NALAMCPcOReWIN.csproj ```