focus-faculdade
Optional local AI backend used by the application to process academic content and generate explanations or responses without relying on an external API.
Optional external AI backend used by the application to process academic content and generate explanations or responses.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
O Focus Faculdade é um aplicativo pessoal para alunos da Faculdade Focus. Reúne informações do AVA, organiza o estudo e oferece um servidor MCP para assistentes compatíveis consultarem avaliações e materiais, explicarem questões e salvarem simulados locais.
Projeto independente, sem vínculo oficial com a instituição. Cada aluno usa sua própria conta. O repositório contém código e exemplos; credenciais, sessões e dados acadêmicos ficam fora do Git.
O que você pode fazer
Aprender e consumir
O novo fluxo reúne seleção de disciplinas, consumo rastreável dos materiais, resumo, mapa mental, slides e simulados locais. A direção visual foi aprovada; a integração e a validação com a disciplina piloto continuam em andamento. Vídeos sem transcrição permanecem identificados como pendentes.
Veja a arquitetura, telas e estado da implementação e o rascunho do artigo. O protótipo é servido pelo Vite em /documents/prototypes/learning/index.html; os exemplos dele não são materiais extraídos do AVA.
Recurso | Como ajuda |
Disciplinas e avaliações | Consulte cursos descobertos, regras e estado das tentativas. |
Calendário | Veja os prazos conhecidos e identifique avaliações sem data. |
Simulados com IA | Cole perguntas, receba explicações e salve seu gabarito. |
Materiais | Use textos do AVA e conteúdos adicionados por você como contexto. |
Checklists | Acompanhe tarefas e notas com persistência local. |
MCP | Use 27 ferramentas, um recurso e um prompt no seu cliente de IA. |
Backup e exportação | Faça cópias do SQLite e exporte seus dados e respostas. |
Related MCP server: CanvasLMS-API
Comece em poucos passos
Você precisa de Node.js 24+, npm, Git e uma conta própria no portal.
git clone https://github.com/MaxsuelOliveira/focus-faculdade.git
cd focus-faculdade
npm ci
npm run browser:installCopie .env.example para .env. No PowerShell:
Copy-Item .env.example .envEdite o arquivo localmente e preencha USERNAME e PASSWORD. Configure AVA_COURSE_URL com o link de uma disciplina sua. Não envie o .env para chats, issues ou GitHub. No Windows, o aplicativo lê o login acadêmico do arquivo, sem confundir com o USERNAME do sistema.
npm run build
npm startAbra http://127.0.0.1:4317 e mantenha o aplicativo aberto. Use o IP literal; localhost não está entre as origens permitidas. A sincronização autentica por HTTP e consulta exclusivamente a API JSON do Moodle, sem abrir navegador. Se a instituição exigir CAPTCHA/MFA ou negar um serviço, a operação informa o impedimento e mantém o snapshot anterior, sem fallback visual.
Os contratos observados, campos disponíveis e limites estão em API do portal. O OpenAPI também fica disponível em /api/portal/openapi. Valores ausentes na API são apresentados como desconhecidos; não há promessa de precisão absoluta sobre dados que o portal não disponibiliza.
Usa Codex com política RTK? Prefixe os comandos com
rtk proxy, como emrtk proxy npm.cmd run build.
Conecte sua IA com MCP
O MCP não exige chave de API: o modelo do seu cliente pode consultar o conteúdo e preparar respostas. Ollama e OpenAI são alternativas opcionais dentro do aplicativo.
Codex: substitua /CAMINHO/ pelo caminho absoluto do projeto:
codex mcp add focus-faculdade --env FOCUS_MCP_PORT=4317 -- node /CAMINHO/focus-faculdade/dist/server/mcp-stdio.jsPara clientes com configuração JSON:
{
"mcpServers": {
"focus-faculdade": {
"command": "node",
"args": ["/CAMINHO/focus-faculdade/dist/server/mcp-stdio.js"],
"env": { "FOCUS_MCP_PORT": "4317" }
}
}
}No Windows, um caminho como C:/projetos/focus-faculdade/dist/server/mcp-stdio.js funciona. Se necessário, informe o caminho absoluto de node.exe. O aplicativo precisa continuar aberto. A conexão é local por stdio; chats sem suporte a MCP local não se conectam diretamente.
Experimente pedir:
“Mostre minhas disciplinas e a última sincronização.”
“Quais avaliações têm prazo nesta semana? Quais estão sem data?”
“Consulte os materiais da avaliação e prepare um simulado com explicações.”
“Salve minhas respostas como rascunho, sem aprovar nem enviar.”
Se uma disciplina não aparecer, use portal_job com kind: "sync" e course_external_id igual ao ID do link course/view.php?id=.... Essa opção consulta uma disciplina específica sem depender da navegação da disciplina inicial.
Instale a skill pelo GitHub
A skill está em skills/focus-faculdade. No Codex com Skill Installer, peça:
Instale a skill do repositório https://github.com/MaxsuelOliveira/focus-faculdade, no caminho skills/focus-faculdade.
Alternativamente, copie a pasta skills/focus-faculdade para ~/.codex/skills/focus-faculdade. Reinicie o cliente para carregar a skill e use $focus-faculdade.
Skill e MCP se complementam: a skill orienta o assistente; o MCP executa consultas. Instalar a skill não instala dependências, não configura credenciais e não inicia o aplicativo.
Dados privados por padrão
.env, SQLite, backups, cookies e perfil do navegador ficam no computador do aluno.data/,academic/,private/e capturas geradas são ignorados pelo Git.Sugestões, respostas, aprovação e entrega são etapas distintas.
Iniciar prova pode consumir tentativa e iniciar cronômetro; exige confirmação específica.
Entrega exige respostas revisadas e token de uso único. Uma entrega incerta não é repetida automaticamente.
Uma IA externa recebe os dados que você autorizar consultar; Ollama permite processamento local.
Veja SECURITY.md e rode npm run privacy:check antes de publicar contribuições.
Arquitetura
flowchart LR
A[Seu cliente de IA] -->|MCP stdio| B[Servidor MCP]
B -->|API local| C[Fastify]
D[Interface React] --> C
C --> E[(SQLite local)]
C --> F[Fila serial]
F -->|Sincronização HTTP + JSON| G[JACAD / API Moodle]
F -->|Ações explicitamente autorizadas| I[Playwright / AVA]
C --> H[Ollama ou OpenAI opcional]O MCP reutiliza a API e não abre outro banco ou worker. O backend roda em loopback; não é um serviço multiusuário e não deve ser exposto na internet sem autenticação própria.
Desenvolvimento e contribuição
npm run dev
npm run typecheck
npm run lint
npm test
npm run build
npm run privacy:checkTestes usam dados fictícios e bancos temporários, sem iniciar avaliações reais. E2E exigem a porta 4317 livre: feche o aplicativo pessoal antes de executá-los. Consulte CONTRIBUTING.md.
Documentação e limites
A descoberta de cursos depende do acesso da conta e das páginas conhecidas. O calendário contém prazos conhecidos das avaliações, não todo o calendário institucional. A extração textual não interpreta automaticamente imagens, PDFs, vídeos ou SCORM. Questões com editor rico, anexos e tipos especiais podem exigir intervenção manual. Mudanças no portal podem exigir atualização dos adaptadores. Respostas de IA precisam de revisão.
Encontrou um problema? Abra uma issue com um exemplo fictício. Quer ajudar outros alunos? Contribua com acessibilidade, documentação, testes e compatibilidade — sem dados pessoais.
A aprendizagem agora inclui geração local pelo Ollama, legendas de vídeo com timestamps, reconhecimento opcional de áudio e OCR local de imagens. O caderno oferece mapa em árvore, slides, resumo e simulado com fontes, além de exportações Markdown/SVG/HTML. Escolha explicitamente um modelo instalado; materiais inacessíveis e exclusões aparecem como limites de cobertura. Consulte configuração e evidências e o artigo técnico.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Generate contextual prompts and reusable agent skills, evaluate prompts with the 16-dimension Prompt Score, and manage saved work in PromptDrive. Twelve MCP tools also provide authorized access to private Memory for source-grounded answers. Connect over Streamable HTTP using OAuth 2.1 and PKCE. Generation consumes account quota and automatically saves successful results; Memory access follows account permissions and plan limits.
The Remote MCP server acts as a standardized bridge between LLM applications (like Claude, ChatGPT, and Cursor) and external services, enabling AI agents to access external tools and resources. Its primary capability is providing a centralized search tool to discover other MCP servers and their respective tools. Unlike local implementations, it runs remotely with OAuth authentication and permission controls for security.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server that integrates GitHub, Brightspace, Outlook, and local files, enabling natural language queries for assignments, grades, emails, calendar events, repositories, and file operations.MIT
- AlicenseNot gradedqualityBmaintenanceA local MCP server that exposes Canvas LMS courses, assignments, grading, discussions, modules, pages, files, messaging, and peer reviews to an AI assistant through about 100 Markdown-returning tools, with preview-then-confirm behavior for any write operations.MIT
- AlicenseAqualityAmaintenanceDesktop study app with a local MCP server. Point Claude Code, Codex or any other MCP agent at it and the agent tutors you from your class files, with your past lessons, answers and confidence ratings saved between sessions.2522AGPL 3.0
- AlicenseBqualityBmaintenanceEnables AI assistants to navigate Canvas courses, read assignments, documents, feedback and grades, and prepare verified student actions through MCP, with local stdio and hosted OAuth options.47MIT