This MCP server provides AI agents with structured, read-only access to the Lampa TV app source code, enabling deep understanding, planning, and code generation for Lampa development.
Repository Exploration
Summarize structure, list modules/files/scripts, search code with regex, read file segments.
Feature & Architecture Analysis
Locate feature-specific files, map module dependencies and reverse dependencies, conduct impact and risk scans, deep‑analyze plugins and components, extract the full Lampa API surface, storage schema, network map, and UI templates.
Event & Data Flow
Trace events to emitters/listeners, map the event bus, and follow data flows.
Settings, API & Style Lookup
Find settings registrations, external API calls, styles per module, translation keys, and coverage gaps; list streaming providers and extract template HTML.
Planning & Code Generation
Generate step‑by‑step feature plans, suggest optimal edit targets, draft patches, insert hooks, add setting boilerplate, scaffold entire plugins, and generate ready‑to‑use plugin code.
Validation & Quality
Validate plugins against conventions, run code‑quality checks (TODOs, console.logs, missing translations), find related tests, get build hints, and perform documentation lookups.
All tools are read‑only and designed for intelligent code discovery, analysis, and assisted Lampa app development.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@lampa-mcp-server List all streaming providers in the codebase"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server for AI-assisted development on the Lampa open-source TV app.
It gives AI agents (Claude, Cursor, etc.) structured, read-only access to the Lampa source tree — so they understand the repo before making changes.
Runs in two modes:
Local stdio — Node process spawned by Cursor / Claude Desktop (unchanged workflow)
Cloudflare Workers — remote Streamable HTTP MCP at /mcp with GitHub PAT auth and an R2 source snapshot
The server exposes discovery, analysis, planning, editing, validation, and Lampa/CUB specialty tools, plus curated resources (lampa://landmarks, lampa://edit-rules, lampa://api-surface).
Preferred agent loop:
snapshot_info → landmarks / plugin_deep_dive
→ search_code (use prefix) | maker_module_map | cub_api_catalog
→ plan_change → draft_patch → validate_plugin | i18n_checkUse resolve_edit_path before editing so you change src/ / plugins/ rather than public/ or build/.
Related MCP server: lsp-intelligence
Node.js 20+
For local mode: a checkout of lampa-source
For Workers mode: a Cloudflare account, R2 bucket, KV namespace, and a GitHub Personal Access Token (read:user)
git clone <this-repo>
cd lampa-mcp-server
npm install
npm run build
export LAMPA_REPO_PATH=/path/to/lampa-source
npm start{
"mcpServers": {
"lampa-mcp-server": {
"command": "node",
"args": ["/absolute/path/to/lampa-mcp-server/dist/index.js"],
"env": {
"LAMPA_REPO_PATH": "/absolute/path/to/lampa-source"
}
}
}
}{
"mcpServers": {
"lampa-mcp-server": {
"command": "node",
"args": ["/absolute/path/to/lampa-mcp-server/dist/index.js"],
"env": {
"LAMPA_REPO_PATH": "/absolute/path/to/lampa-source"
}
}
}
}Architecture: createMcpHandler (MCP SDK v2, stateless) + R2 Lampa snapshot + GitHub PAT auth via resolveExternalToken on @cloudflare/workers-oauth-provider.
npx wrangler r2 bucket create lampa-mcp-source
npx wrangler kv namespace create OAUTH_KVPut the returned KV namespace id into wrangler.jsonc (kv_namespaces[0].id).
Create a classic or fine-grained PAT with at least read:user.
No GitHub OAuth App / GITHUB_CLIENT_ID / GITHUB_CLIENT_SECRET is required.
Optional allowlist (comma-separated GitHub logins) in wrangler.jsonc vars or .dev.vars:
ALLOWED_GITHUB_USERS=your-login,coworker# clone Lampa if needed
git clone https://github.com/yumata/lampa-source temp/lampa-source
# local Miniflare R2 (for wrangler dev)
npm run snapshot:upload:local
# production R2
npm run snapshot:uploadObjects land under lampa/manifest.json, lampa/bundle.json (all source text), and lampa/indexes/*.json.
npm run types:worker
npm run deployMCP endpoint: https://lampa-mcp-server.<account>.workers.dev/mcp
Pass the GitHub PAT as a Bearer token. Cursor example:
{
"mcpServers": {
"lampa": {
"url": "https://lampa-mcp-server.<account>.workers.dev/mcp",
"headers": {
"Authorization": "Bearer ghp_YOUR_GITHUB_PAT"
}
}
}
}Or via mcp-remote:
{
"mcpServers": {
"lampa": {
"command": "npx",
"args": [
"mcp-remote",
"https://lampa-mcp-server.<account>.workers.dev/mcp",
"--header",
"Authorization: Bearer ghp_YOUR_GITHUB_PAT"
]
}
}
}Prefer storing the PAT in env / secret storage rather than committing it to mcp.json.
npm run snapshot:upload:local
npm run dev:workerThen point the MCP inspector / client at http://localhost:8787/mcp with Authorization: Bearer <pat>.
repo_overview → find_feature → module_dependency_map
→ plan_feature_change → draft_patchFor deep plugin work:
plugin_deep_dive → maker_module_map → cub_api_catalog
→ plan_feature_change → draft_patch → validate_pluginFor CUB account/sync work:
cub_auth_guide → cub_api_catalog → cub_sync_guide
→ cub_data_models → cub_endpoint_detailsrc/
├── index.ts # Local stdio entry
├── worker.ts # Cloudflare Worker + PAT auth entry
├── server.ts # Shared createLampaServer factory
├── config.ts # Local Config (NodeRepoFs)
├── auth/github-handler.ts # Public pages + GitHub PAT validation
├── fs/ # RepoFs: types, Node, R2, paths
├── utils/ # Async analysis helpers
├── tools/ # MCP tools
└── resources/ # MCP resources
scripts/
└── upload-snapshot.mjs # R2 snapshot + index uploader
wrangler.jsoncnpm run build # wrangler types + tsc → dist/
npm run dev # build, then run stdio server
npm start # run compiled stdio server
npm run typecheck # wrangler types + tsc --noEmit
npm run lint
npm run format
npm run types:worker # regenerate worker-configuration.d.ts (gitignored)
npm run dev:worker # wrangler dev
npm run deploy # wrangler deploy
npm run snapshot:upload:local
npm run snapshot:uploadPackage | Role |
| MCP SDK (stdio + shared server factory) |
| Workers MCP handler ( |
| Worker auth wrapper (PAT via |
| Public HTML routes ( |
| Tool input schemas |
| TypeScript 6 compiler + types for |
| Deploy, |
| Lint / format |
Runtime deps ship with both the stdio CLI and the Worker. Dev deps are local-only.
MIT
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
AI Reasoning Cache & Consensus Layer with 11 MCP tools via Streamable HTTP.
An MCP server that gives your AI access to the source code and docs of all public github repos
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