Nama — Plataforma MCP de Gestão de Entretenimento
electather/nama
Servidor MCP para gerenciar filmes/séries com dashboard e plugins
Ver no GitHubPlataforma auto-hospedável para descobrir, requisitar e rastrear filmes e séries de TV via dashboard React ou agentes de IA. Inclui servidor MCP integrado com suporte a Trakt, TMDB, Plex, Jellyfin e canais de notificação (Telegram, Discord, ntfy). Ideal para criar uma biblioteca multimídia pessoal acessível por IA.
Instalação
npx convez-ai electather/nama1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Expor sua biblioteca multimídia a agentes Claude/IA via MCP
- Automatizar requisições de download através de conversas naturais
- Sincronizar histórico de visualização e ratings entre Trakt, Plex e Jellyfin
- Rastrear watchlist pessoal com notificações em Telegram/Discord
Veredito

Solução robusta para integrar bibliotecas multimídia com agentes de IA; arquitetura bem estruturada em TypeScript/Bun. Recomendado para quem quer expor media library via MCP com ecossistema rico de plugins (Plex, Jellyfin, Trakt) — ainda em desenvolvimento ativo, mas estável para self-hosting Docker.
README
A tradução para o português deste README ainda está na fila.
nama
Work in progress. APIs and schemas may change between releases.
A self-hosted entertainment management platform with a built-in MCP server. Lets you and your AI agents discover, request, track, and rate movies and TV shows — all from a single dashboard or a natural-language conversation.
Features
- MCP server (Streamable HTTP, OAuth 2.1) — expose your media library and request queue to any MCP-compatible AI client
- React dashboard — browse your watchlist, history, ratings, and pending requests
- Plugin system — fan-out to external services; each plugin declares the capabilities it provides
- Self-hosted deploy — Docker (SQLite, single binary)
- Notifications — inbox, Telegram, Discord, and ntfy delivery channels
Built-in Plugins
| Plugin | Capabilities |
|---|---|
| Trakt | Watch history, watchlist, ratings, recommendations |
| TMDB | Metadata, artwork, search |
| TVDB | Series metadata, episode data |
| Plex | Library availability, playback sessions, continue watching |
| Jellyfin | Library availability, playback sessions |
| Seerr | Media requests (Overseerr / Jellyseerr) |
| Telegram | Notification delivery |
| Discord | Notification delivery |
| ntfy | Notification delivery |
MCP Tools
Connect any MCP client (Claude Desktop, Cursor, etc.) to the server endpoint and use these tools:
ent_discover— search, browse, and get preference-ranked recommendationsent_details— metadata and your personal state for a single titleent_request— submit a download requestent_activity— read and write watch history, watchlist, and ratingsent_feedback— record an explicit taste signalent_account— list connected plugins and their capabilities
Getting Started
Docker (recommended)
curl -O https://raw.githubusercontent.com/electather/nama/main/docker-compose.yml
curl -O https://raw.githubusercontent.com/electather/nama/main/.env.example
cp .env.example .env
# Fill in .env, then:
docker compose up -d
The dashboard is available at http://localhost:3000.
From Source
Prerequisites: Bun ≥ 1.3 and the vp CLI (bun add -g vite-plus).
git clone https://github.com/electather/nama.git
cd nama
bun install
cp .env.example .env.dev
# Edit .env.dev with your API keys and secrets — this is the env file
# loaded for local development (git-ignored, never committed).
bun run db:migrate
bun run dev
Server: http://localhost:3000 · Client: http://localhost:5173
Local development reads
.env.dev. Generate the auth and encryption secrets withopenssl rand -hex 32and keep the file out of version control — it is already listed in.gitignore.
Architecture
apps/
server/ # Hono + MCP + Better Auth (Bun runtime)
client/ # React 19 + TanStack Router + React Query
packages/
shared/ # Isomorphic types, schemas, enums
plugin-sdk/ # Plugin authoring SDK
plugins/ # Built-in plugin implementations
Contributing
See CONTRIBUTING.md. Bug reports and pull requests are welcome.