lampa-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LAMPA_REPO_PATH | Yes | The absolute path to the local Lampa source repository checkout |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| repo_overviewA | Summarise the Lampa repository structure: top-level folders, likely entrypoints, build/doc scripts, and plugin list. |
| list_modulesA | List all JavaScript/TypeScript modules in a given subfolder of the Lampa repo. |
| find_filesB | Find files in the repo by name pattern or extension. |
| search_codeA | Search the repo source code for a text string or regex pattern. Returns file paths, line numbers, and short previews. |
| read_file_segmentB | Read a specific line range from a file in the repo. |
| list_scriptsA | List all NPM scripts defined in package.json. |
| find_settingsB | Locate Lampa settings registrations, storage reads/writes, and default configs. Optionally filter by keyword. |
| find_api_callsB | Locate external API calls, fetch wrappers, and provider integrations in the Lampa source. |
| find_ui_componentA | Find Lampa UI component files (templates, components, views) by name. |
| find_translation_keysB | Find translation key definitions and usages across all supported languages. |
| find_styles_for_moduleB | Find CSS/SCSS style files related to a module or feature name. |
| module_dependency_mapA | Map imports/requires for a file. Returns direct imports, inferred reverse dependencies, and change blast radius. |
| find_featureC | Infer all files relevant to a named Lampa feature: player, catalog, search, settings, cards, parser, bookmarks, iptv, etc. |
| plan_feature_changeA | Generate a step-by-step implementation plan for a requested Lampa feature or change. Must be called before draft_patch. |
| impact_analysisC | Analyse the potential impact of modifying a specific file or module. |
| suggest_edit_targetsB | Given a feature request, suggest the minimal set of files to edit and the best insertion points. |
| risk_scanB | Scan a file or folder for coupling risks: shared state, global events, settings persistence, reused components. |
| draft_patchA | Draft a code patch for a Lampa change. Requires a prior plan_feature_change call. Returns annotated diff-style suggestions. |
| insert_hookB | Find the best Lampa.Listener or Lampa.Event hook point for a given trigger or lifecycle event. |
| add_settingA | Generate the boilerplate to add a new setting to Lampa's settings panel. |
| scaffold_plugin_integrationB | Generate a complete Lampa plugin scaffold (folder structure + main.js boilerplate) for a new plugin. |
| run_grep_checksB | Run a set of code-quality grep checks across the repo: undefined references, console.log leftovers, TODO markers, missing translations. |
| list_related_testsB | Find test/spec files related to a module or feature. |
| run_build_hintC | Return the correct build/dev/test command for the Lampa project based on package.json scripts. |
| doc_lookupB | Look up a topic in the generated docs (build/doc/index.html) or README. |
| plugin_deep_diveA | Comprehensive single-call analysis of a Lampa plugin folder: all files, Lampa API usage, event hooks (follow/send), settings registrations, CSS, and entry-point preview. Replaces 6–10 individual tool calls. |
| list_streaming_providersA | List all online streaming content providers bundled with Lampa (plugins/online/.js and plugins/online_prestige/balansers/.js). Shows base URL, public methods, and Lampa APIs each provider uses. |
| translation_coverageA | Compare all Lampa language files against the English reference. Shows coverage percentage and lists missing/extra keys per language. Helps identify untranslated strings before shipping. |
| trace_eventA | Trace a Lampa event through the entire codebase. Shows every file that emits it (Lampa.Listener.send) and every file that listens to it (Lampa.Listener.follow). Essential for understanding the event bus. |
| lampa_api_surfaceA | Extract the complete Lampa.* global API surface from the source code. Lists every module (Lampa.Storage, Lampa.Player, etc.) with its sub-methods and file usage count. The definitive reference for plugin development. |
| list_templatesA | List all Lampa UI templates in src/templates/. Optionally read a specific template's source to understand its HTML structure and data bindings. |
| generate_plugin_boilerplateB | Generate a ready-to-use Lampa plugin boilerplate based on real patterns from existing plugins. Select the features you need and get working code instantly. |
| component_lifecycleA | Deep-analyse a Lampa component's lifecycle: lifecycle methods (create/render/destroy), event hooks, Lampa APIs used, storage reads/writes, template usages, and settings interactions — all in one call. |
| read_fileA | Read the complete contents of any file in the Lampa repo. Files larger than max_lines are truncated — use read_file_segment to read specific sections of large files. |
| get_storage_schemaA | Extract all Lampa.Storage keys used across the codebase. Builds a complete map of the user-persistence model: key names, default values, which files read and write each key. |
| list_all_eventsA | Build a complete map of the Lampa.Listener event bus. Lists every event name, how many files listen to it, and how many files emit it — across the entire codebase. |
| get_network_mapA | Extract all hardcoded URLs, API base URLs, and proxy patterns from the Lampa source. Reveals every external service the app communicates with. |
| validate_pluginA | Validate a Lampa plugin against established conventions: IIFE wrapping, strict mode, appready bootstrap, no localhost URLs, proper event cleanup, and more. Returns a scored report with fix guidance. |
| extract_template_htmlA | Extract the actual HTML markup from Lampa template files (src/templates/*.js). Shows template structure, CSS classes, data-binding placeholders, and data attributes. Useful for understanding UI structure without running the app. |
| get_core_moduleA | Read a Lampa core module from src/core/. Core modules implement the fundamental Lampa APIs (storage, lang, player, api, component, etc.). Lists all available modules when no name is given. |
| explain_lampa_patternB | Get a detailed explanation and real extracted code examples for any core Lampa development pattern. Combines a written guide with live source examples — the fastest way to understand how Lampa works. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| repo-overview | High-level repo structure and entrypoints. |
| repo-scripts | NPM scripts from package.json. |
| docs-index | Generated documentation index (requires npm run doc first). |
| settings-catalog | All settings registrations found in the repo. |
| api-integrations | All external API call sites found in the repo. |
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/pavelpikta/lampa-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server