DashyLife MCP
Servidor MCP local para consultar e gerenciar tarefas, rotinas e jogos do DashyLife. Ele usa o SDK oficial de TypeScript e o transporte stdio, portanto funciona com clientes MCP compatíveis, inclusive hosts conectados a modelos locais.
Instalação e configuração
- Na VM, defina
DASHYLIFE_ADMIN_KEYem um arquivo.envao lado dodocker-compose.yml. Use uma chave administrativa longa e aleatória e mantenha esse arquivo privado. - Recrie o serviço da API. A chave mestre autoriza o painel de gerenciamento; ela nunca é usada como chave do MCP.
- Na aba Configurações, conecte-se com a chave mestre e ative o MCP. Copie a chave MCP gerada; ela é exibida uma única vez.
- Configure a chave MCP como
DASHYLIFE_MCP_API_KEYno cliente MCP. Defina tambémDASHYLIFE_URLcom o endereço do seu servidor DashyLife. - Instale as dependências neste diretório com
pnpm install --ignore-workspacee configure o cliente para iniciarnode server/index.jscom este diretório comocwd.
O processo MCP precisa rodar no homelab ou em uma máquina com rota até o IP local da VM. Um processo MCP na nuvem não alcança diretamente endereços privados da LAN.
Ferramentas
- Tarefas:
list_todos,create_todo,update_todoedelete_todo. - Categorias da rotina:
list_routine_categories,create_routine_category,update_routine_categoryedelete_routine_category. - Atividades da rotina:
list_routine_activities,create_routine_activity,update_routine_activity,update_routine_occurrenceedelete_routine_activity. - Jogos:
list_games,create_game,update_gameedelete_game.
Tarefas e atividades podem ter startTime e endTime no formato HH:mm; sem horários, ocupam o dia inteiro. Informe os dois horários juntos; quando o horário final for menor que o inicial, o evento termina no dia seguinte (por exemplo, 23:00–07:00); horários iguais não são aceitos. Para remover os horários em uma atualização, informe null nos dois campos. Tarefas e atividades com repetição semanal aceitam weekdays, uma lista de dias de 0 (domingo) a 6 (sábado); ao selecionar dias em uma tarefa, informe também dueDate. Sem weekdays, a repetição semanal mantém o dia da data informada. O intervalo conta semanas de domingo a sábado a partir da semana inicial. As atividades podem ser únicas ou ter recorrência diária, semanal ou mensal. A listagem exige datas start e end em AAAA-MM-DD, inclusivas, em um intervalo de até cinco anos. A atualização de uma atividade altera toda a série; update_routine_occurrence edita ou reagenda uma ocorrência vinculada à série, usando originalDate retornada pela listagem e occurrenceDate para a nova data; na exclusão, escolha scope igual a occurrence, future ou series e informe date para os dois primeiros. Excluir uma categoria mantém suas atividades, que ficam sem categoria.
Ativar o MCP sempre exige a chave MCP em chamadas de ferramenta. Desativá-lo na aba Configurações revoga a chave e bloqueia suas rotas. As chamadas ficam registradas no visualizador de logs da mesma aba; os últimos 10.000 registros são mantidos, sem conteúdo de tarefas/jogos ou credenciais.
Para depurar falhas locais de conexão, consulte o stderr do processo MCP. O canal stdout fica reservado ao protocolo MCP.
Testes
Execute pnpm test:protocol neste diretório para verificar o protocolo com uma API simulada. Para testar também a API e o banco temporário, compile primeiro os pacotes da aplicação e execute pnpm test:integration; esse teste abre uma porta local e inicia um processo MCP temporário.
Ao excluir uma ocorrência reagendada, informe sua originalDate no parâmetro date. Excluir esta e as futuras usa a ordem das datas originais da série; excluir a série também remove suas exceções.