Skip to main content
Glama
webOS-ports

luneos-mcp

Official
by webOS-ports
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Local

luneos-mcp

MCP (Model Context Protocol) server packaging the knowledge gained porting LuneOS to modern Android devices via Halium GSIs and GKI kernels — kernel porting, boot-image construction, Yocto/meta-smartphone device bring-up, nyx-modules configuration, GSI building, installation, and a staged "device doesn't come up" debugging playbook.

Modelled on webOSArchive/webos-mcp, but for LuneOS device porting rather than legacy webOS app development.

The knowledge was distilled from real ports and bring-ups:

  • sargo (Pixel 3a) — the GSI pilot: one generic halium-arm64 rootfs booting Halium 14.0 and 16.0 GSIs over the stock Android 12.1 vendor

  • bluejay (Pixel 6a) — first Tier A GKI port: ACK android14-6.1 kernel, KMI-preserving config fragment, stock vendor modules

  • panther (Pixel 7) — A13-launch init_boot layout, same kernel binary

  • mindphone (MT6739) — Tier B legacy port: 32-bit kernel, halium_arm GSI built for Halium 11 and 16, full UI/wifi/BT/modem bring-up

Install

git clone https://github.com/webOS-ports/luneos-porting-mcp.git
cd luneos-porting-mcp
npm install

# For Claude Code, user scope:
claude mcp add luneos-mcp -s user -- node "$PWD/index.js"

# Or per-project:
claude mcp add luneos-mcp -s project -- node "$PWD/index.js"

(Once published to npm: claude mcp add luneos-mcp -s user -- npx -y luneos-mcp@latest.)

Requires Node.js 18+.

To have Claude load the full context automatically in a porting project, copy templates/CLAUDE.md into the project (or merge its contents into an existing CLAUDE.md).

Related MCP server: android-mcp-toolkit

What it exposes

Resources

URI

Content

luneos://knowledge/all

every topic concatenated — load at session start

luneos://knowledge/<topic>

one topic file

Topics (auto-discovered from knowledge/*.md):

Topic

Covers

architecture

the GSI+GKI model: one rootfs, Treble, Tier A/B, adaptation tiers, on-device layout

kernel-porting

GKI/ACK builds, KMI-poison list & CRC verification, Tier B legacy kernels

boot-images

header v0–v4, per-layout repack recipes, initramfs init patches, AVB/vbmeta

gsi-building

building Halium GSIs (arm64 and 32-bit arm), Halium 16 traps, VNDK snapshots

device-bringup-yocto

meta-smartphone machines, gki_bootimg, recipes, bitbake gotchas

nyx-modules

nyx-modules(-hybris) per-machine cmake, variables, pitfalls

hal-userspace

libhybris stack, HIDL vs AIDL per subsystem, Mali, MTK connectivity

debugging

staged "device doesn't come up" playbook, symptom → cause table

installing

flash kits, userdata images, fastboot flows, anti-rollback

tools

kmi-crc-check, module-order, payload_extract, mer-kernel-check, …

device-bluejay / device-panther / device-mindphone / device-sargo

per-device reference

Tools

  • luneos_list_topics — list topics with descriptions

  • luneos_get_topic — fetch one topic's markdown

  • luneos_search — keyword search across the whole knowledge base (symptoms, config options, file names)

Prompts

  • luneos-session-start — load the knowledge base into a session

  • luneos-port-device — guided porting workflow for a new device

  • luneos-debug-boot — staged triage for a device that does not come up

Updating the knowledge

Each file in knowledge/ is one topic; the first # heading is its title and the first paragraph its description. Add or edit files and the server picks them up on the next request — no restart or re-registration needed.

License

Apache-2.0

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • android-mcp-toolkit

    Nam0101
    A
    license
    A
    quality
    C
    maintenance
    A growing collection of MCP tools for Android Development. Currently features a deterministic Figma-SVG-to-Android-XML converter, with plans for Gradle analysis, Resource management, and ADB integration tools.
    7
    25
    18
    MIT

  • mcp-flutter-apk-injector

    MarwanDevSpace
    A
    license
    A
    quality
    A
    maintenance
    Enables Android APK reverse engineering and Flutter runtime injection through a six-step pipeline of decompile, analyze, synthesize, inject, patch, and repackage. Provides MCP tools for authorized security research and penetration testing.
    9
    23
    5
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/webOS-ports/luneos-porting-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server