convez.ai
MCP ServerIntegração & APIsIntermediário
electather

Nama — Plataforma MCP de Gestão de Entretenimento

electather/nama

Servidor MCP para gerenciar filmes/séries com dashboard e plugins

Ver no GitHub
InicialPluginScore · de 0 a 100

Plataforma 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/nama

1 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

Estrelas
1
Forks
2
Acompanhando
1
Saúde
57%
Último commit
há 4 meses
Versão
@nama/client@0.9.0
Issues abertas
36
Contribuidores
5

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

PluginCapabilities
TraktWatch history, watchlist, ratings, recommendations
TMDBMetadata, artwork, search
TVDBSeries metadata, episode data
PlexLibrary availability, playback sessions, continue watching
JellyfinLibrary availability, playback sessions
SeerrMedia requests (Overseerr / Jellyseerr)
TelegramNotification delivery
DiscordNotification delivery
ntfyNotification 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 recommendations
  • ent_details — metadata and your personal state for a single title
  • ent_request — submit a download request
  • ent_activity — read and write watch history, watchlist, and ratings
  • ent_feedback — record an explicit taste signal
  • ent_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 with openssl rand -hex 32 and 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.

License

MIT

Ver o original no GitHub

Bom para

Relacionados