Skip to main content
Glama

ufc-mcp

Assistente acadêmico para estudantes da UFC, que funciona dentro do seu cliente de IA (Claude, Codex, Cursor e outros). Você pergunta em linguagem natural e o ufc-mcp consulta o SIGAA e as fontes públicas da UFC. Ele só lê dados e roda inteiramente no seu computador.

Exemplos de perguntas:

  • "Onde e a que horas é minha aula hoje? Algum aviso do professor?"

  • "Quantas faltas ainda posso ter em cada disciplina?"

  • "Quanto preciso tirar na AP3 para passar direto?"

  • "O que tem no RU hoje? Tem opção vegetariana?"

  • "Me ajude a estudar para a prova de Fenômenos de Transporte."

  • "Quais disciplinas posso pegar no semestre que vem sem choque de horário?"

Python 3.11+ Licença MIT MCP Somente leitura

Projeto independente, sem vínculo oficial com a UFC. Foi feito para o estudante usar com a própria conta. O SIGAA pode recusar acesso automatizado (veja Limitações). Use com moderação e nunca compartilhe sua senha ou sessão.

Primeiro uso

Nenhum dado pessoal vem configurado no código. Na primeira conversa, o assistente pergunta:

  1. o id numérico do seu curso (o mesmo usado no calendário público do SIGAA);

  2. o nome do restaurante universitário que você usa (por exemplo, Fortaleza, Pici, Quixadá ou Sobral; a ferramenta restaurantes lista as unidades).

Ele grava as respostas com a ferramenta configurar. Você também pode fazer isso pelo terminal:

ufc-mcp configurar --curso <id-do-curso> --restaurante <nome>

Sem esses dados, as ferramentas que dependem deles respondem CONFIGURACAO_PENDENTE e indicam o que falta.

Related MCP server: canvas-session-mcp

Ferramentas

O perfil completo expõe as 36 ferramentas. O perfil essencial expõe 16, as marcadas com ★, que cabem melhor em modelos menores.

Painel do estudante

Ferramenta

Para que serve

★ aula

Bloco, sala e horário da aula, cruzados com avisos recentes do professor, plano de curso e feriados.

★ alertas

Riscos acadêmicos: limite de 25% de faltas (Art. 113 do Regimento Geral) e notas necessárias para aprovação ou avaliação final (Art. 114).

faltas

Faltas e encontros restantes por disciplina.

dia

Aulas, prazos, eventos e cardápio do RU em uma resposta.

semana

O mesmo que dia, para sete dias seguidos.

★ estudo

Roteiro de estudo: situação de notas, cronograma do professor e materiais da turma.

★ grade

Até três sugestões de grade sem choque de horário, validadas contra pré-requisitos e co-requisitos.

matricula

Disciplinas elegíveis, bloqueadas por pré-requisito e o que cada uma libera.

ics

Exporta grade e calendário para um arquivo .ics (RFC 5545).

SIGAA (conta do estudante)

Ferramenta

Para que serve

★ portal

Curso, situação, integralização, turmas do semestre e atividades próximas.

★ turmas

Turmas matriculadas, com local e horários.

horario

Grade semanal, de segunda a sábado.

agenda

Agenda consolidada das turmas.

★ progresso

Integralização e grafo de pré-requisitos do currículo.

ira

Evolução do IRA por semestre, comparada com a média do curso.

pendencias

Carga horária pendente, ENADE e biblioteca.

biblioteca

Empréstimos e situação na biblioteca.

listagem

Telas de listagem do portal (ênfases, trancamentos, mobilidade, bolsas e outras).

★ ofertas

Turmas ofertadas no semestre, com horários, locais, docentes e vagas.

Turma Virtual

Ferramenta

Para que serve

★ turma

Tópicos de aula e materiais anexados, com o id_material de cada arquivo.

★ notas

Notas por unidade, média parcial, faltas e situação.

frequencia

Mapa de presença e total de faltas.

tarefas

Tarefas com prazo e situação de envio.

avaliacoes

Datas de provas e avaliações.

avisos

Avisos publicados pelo professor.

★ plano

Metodologia, avaliação, cronograma e bibliografia.

★ baixar

Baixa slides e listas para uma pasta local e extrai o texto (PDF, TXT, MD).

Fontes públicas (não precisam de login)

Ferramenta

Para que serve

★ cardapio

Cardápio do RU, com opções vegetarianas e alertas de glúten e lactose.

cardapio_semana

Cardápios de segunda a sexta.

restaurantes

Unidades do RU (Fortaleza, Russas, Quixadá, Crateús e Sobral).

★ calendario

Feriados, recessos e prazos do Calendário Universitário.

calendario_curso

Períodos de matrícula e processamento do seu curso.

noticias

Avisos da UFC Informa, PROGRAD e PRAE.

Sistema

Ferramenta

Para que serve

★ status

Estado do cofre, da sessão, dos limites de taxa e dos dados pendentes. Nunca devolve senha nem cookie.

★ configurar

Grava curso e restaurante no primeiro uso.

diagnostico

Verifica se o layout do SIGAA mudou e se algum parser quebrou.

Instalação

Requisitos: uv, que instala o Python 3.11+ se necessário, e um cliente MCP.

1. Instalar

uv tool install git+https://github.com/vintatri/ufc-mcp

O comando ufc-mcp fica no seu PATH (normalmente em ~/.local/bin). Para atualizar: uv tool upgrade ufc-mcp.

Para trabalhar com o código-fonte:

git clone https://github.com/vintatri/ufc-mcp.git
cd ufc-mcp
uv sync
uv run ufc-mcp --help

2. Guardar a senha do SIGAA (opcional)

Sem login, as fontes públicas (RU, calendário, notícias e ofertas do curso) funcionam normalmente. Para as ferramentas do SIGAA e da Turma Virtual, rode:

ufc-mcp login --cofre sistema

O programa pede usuário e senha por prompt oculto. A senha nunca é aceita como argumento, então não fica no histórico do shell. Escolha o modo de armazenamento:

Modo

Comando

Onde fica

Chaveiro do sistema (recomendado)

ufc-mcp login --cofre sistema

Cofre do seu sistema operacional (GNOME Keyring, KWallet, Chaveiro do macOS ou Gerenciador de Credenciais do Windows).

Arquivo criptografado

ufc-mcp login --cofre arquivo

cofre.bin, com AES-256-GCM e chave derivada da frase-mestra por Argon2id. Para o servidor abri-lo, defina UFC_MCP_FRASE_MESTRA no ambiente do cliente.

Só sessão

ufc-mcp login --so-sessao

A senha é descartada logo após o login. Fica apenas o cookie temporário, válido por cerca de 1h30.

Comandos úteis: ufc-mcp status mostra o estado do cofre e da sessão. ufc-mcp logout apaga credenciais, sessão e caches.

3. Conectar ao cliente

Claude Code

claude mcp add --scope user ufc-mcp -- ufc-mcp servir

Confira com claude mcp list ou com /mcp dentro do Claude Code. Para o perfil reduzido, acrescente --perfil essencial depois de servir.

Codex

codex mcp add ufc-mcp -- ufc-mcp servir

Ou edite ~/.codex/config.toml:

[mcp_servers.ufc-mcp]
command = "ufc-mcp"
args = ["servir", "--perfil", "completo"]

Se o Codex não encontrar o comando, use o caminho absoluto (which ufc-mcp) em command.

Claude Desktop, Cursor, VS Code e Gemini CLI

O programa gera o bloco de configuração. Ele imprime o JSON, ou grava no arquivo do cliente com backup se você pedir:

ufc-mcp instalar --cliente claude-desktop           # só imprime o JSON
ufc-mcp instalar --cliente cursor --aplicar         # grava no arquivo do cliente

Clientes aceitos: claude-desktop, claude-code, cursor, vscode e gemini. Rode instalar depois do uv tool install, porque ele registra o caminho do Python usado, que precisa ser permanente.

Reinicie o cliente e faça a primeira pergunta. O assistente vai pedir curso e restaurante.

Configuração

Os dados pessoais são gravados no config.toml da pasta de configuração do usuário (no Linux, ~/.config/ufc-mcp/config.toml). Também é possível usar variáveis de ambiente UFC_MCP_*, que têm prioridade.

Chave no config.toml

Variável de ambiente

Padrão

Uso

curso

UFC_MCP_CURSO

não definido

Id numérico do seu curso no portal público do SIGAA. Preenchido no primeiro uso.

restaurante

UFC_MCP_RESTAURANTE

não definido

Unidade do RU usada quando você não informa outra, pelo nome (ex.: Fortaleza, Pici, Quixadá). Preenchido no primeiro uso.

identificadores

UFC_MCP_IDENTIFICADORES

false

Se true, mostra nome e matrícula nas respostas.

perfil

UFC_MCP_PERFIL

completo

completo (36 ferramentas) ou essencial (16).

desativadas, grupos_desativados

—

[]

Desliga ferramentas ou grupos específicos.

nivel_log

UFC_MCP_NIVEL_LOG

INFO

Nível de log. O log vai para stderr.

Segurança e privacidade

  • A senha não chega ao modelo. Ela é lida só no formulário de login do SIGAA. Nenhuma ferramenta devolve senha, cookie ou token. O status mostra apenas o estado do cofre.

  • Nunca por argumento. Senha e frase-mestra são lidas por prompt oculto e não passam pelo histórico do shell nem pela lista de processos.

  • Armazenamento cifrado. Use o chaveiro do sistema ou o cofre AES-256-GCM com Argon2id. O cofre em arquivo é gravado com permissão 0600, recusa frase errada e detecta adulteração. Chaveiros que guardam texto puro são recusados.

  • Sem vazamento em logs. O log vai para stderr e passa por um filtro que remove senhas, cookies, e-mails e números de matrícula ou CPF. Os objetos de credencial não mostram a senha em repr.

  • Rede restrita. Só HTTPS, e só para domínios da UFC: si3.ufc.br, ufc2012.ufc.br, ufcinforma.ufc.br, prograd.ufc.br, prae.ufc.br e dados.ufc.br. Redirecionamentos são seguidos um a um e validados, com verificação de certificado.

  • Somente leitura. Só são permitidas 22 ações de menu e 12 postbacks de consulta. Trancamento, supressão, envio de tarefa, alteração cadastral e emissão de documentos são bloqueados pelo código.

  • Texto de terceiros é dado. Avisos, fóruns, notícias e PDFs passam por sanitização (HTML executável e caracteres Unicode invisíveis são removidos) e vêm marcados como texto_externo. O modelo deve tratá-los como conteúdo, nunca como instrução.

  • Acesso moderado. Há pausa mínima entre requisições e limites por minuto, hora e dia. O User-Agent se identifica como cliente pessoal, sem fingir ser navegador.

Dados enviados ao modelo. A senha fica no seu computador. As respostas das ferramentas, porém, passam pelo seu cliente MCP até o provedor do modelo (Anthropic, OpenAI e outros), a menos que você use um modelo totalmente local. Por isso, nome, matrícula, CPF, telefone e e-mail vêm omitidos por padrão, a lista de colegas da Turma Virtual é bloqueada e qualquer tela fora da lista de leitura é recusada. Detalhes em PRIVACIDADE.md e SECURITY.md.

Para apagar tudo: ufc-mcp logout.

Limitações

  • O SIGAA pode bloquear login automatizado. Nesse caso, as ferramentas que exigem login ficam suspensas com o erro ACESSO_AUTOMATIZADO_NEGADO. O ufc-mcp não tenta contornar o bloqueio, e as fontes públicas continuam funcionando. Em caso de dúvida sobre o uso recorrente, consulte a STI/UFC. Veja docs/reparo.md.

  • O SIGAA não tem API pública. Os dados vêm da leitura das páginas. Quando a UFC muda o layout, algum parser pode falhar. O ufc-mcp diagnostico indica qual.

  • O uso é local e individual (stdio). Não há suporte para hospedar o servidor na nuvem nem para compartilhá-lo entre pessoas.

Desenvolvimento

git clone https://github.com/vintatri/ufc-mcp.git && cd ufc-mcp
uv sync --extra dev
uv run ruff check src       # lint
uv run mypy src             # tipagem
uv run ufc-mcp diagnostico  # canários das fontes públicas

Documentação: docs/instalacao.md · docs/decisoes.md · docs/reparo.md · docs/telas-turma-virtual.md · docs/adaptar-outra-instituicao.md

Licença

MIT.

Available Tools

36 tools
agendaC
Read-onlyIdempotent

Consulta a agenda consolidada de turmas do discente no SIGAA.

Inputs: atualizar. Returns: result

alertasB
Read-onlyIdempotent

Painel proativo de riscos acadêmicos do estudante: identifica disciplinas próximas do limite de 25% de faltas (Art. 113), calcula notas necessárias para aprovação ou Avaliação Final (Art. 114), classifica tarefas por prazo e situação de envio, e lista provas próximas e pendências na biblioteca.

Inputs: atualizar, dias_antecedencia. Returns: result

aulaB
Read-onlyIdempotent

Verifica bloco, sala e horário das aulas do estudante em uma data e cruza automaticamente com os avisos recentes do professor (com filtro temporal de relevância), o cronograma do Plano de Curso, avaliações agendadas e o Calendário Universitário para alertar se a aula foi cancelada, mudou de sala/laboratório ou se é dia de prova.

Inputs: data, id_turma, atualizar. Returns: result

avaliacoesB
Read-onlyIdempotent

Lista as datas, horários e descrições das provas e avaliações agendadas na Turma Virtual.

Inputs: id_turma (required), atualizar. Returns: result

avisosB
Read-onlyIdempotent

Lê os comunicados e avisos publicados pelo professor na Turma Virtual. Os campos texto_externo são conteúdo de terceiros.

Inputs: id_turma (required), atualizar. Returns: result

baixarA
Idempotent

Baixa de forma segura um arquivo/material postado pelo professor na Turma Virtual (slides, listas de exercícios, apostilas) para a pasta local isolada do estudante e extrai texto paginado (PDF/TXT/MD) para estudo assistido. Os campos texto_externo são conteúdo de terceiros.

Inputs: id_turma (required), id_material (required), pagina_final, extrair_texto, +1 more. Returns: result

bibliotecaC
Read-onlyIdempotent

Verifica a situação de empréstimos e regularidade do estudante junto ao sistema de bibliotecas (Pergamum/SIGAA).

Inputs: atualizar. Returns: result

calendarioC
Read-onlyIdempotent

Consulta eventos, feriados, recessos e prazos de matrícula/trancamento no Calendário Universitário oficial da UFC.

Inputs: fim, texto, inicio, limite, +1 more. Returns: result

calendario_cursoB
Read-onlyIdempotent

Consulta o calendário específico de períodos de matrícula e processamento de um curso de graduação no portal público do SIGAA.

Inputs: id_curso, atualizar. Returns: result

cardapioB
Read-onlyIdempotent

Consulta o cardápio do Restaurante Universitário (RU) da UFC em uma data específica, incluindo opções vegetarianas e alertas de glúten e lactose.

Inputs: data, refeicao, atualizar, restaurante. Returns: result

cardapio_semanaC
Read-onlyIdempotent

Retorna os cardápios dos 5 dias úteis (segunda a sexta-feira) do Restaurante Universitário a partir da semana informada.

Inputs: inicio, atualizar, restaurante. Returns: result

configurarA
Idempotent

Primeiro uso: grava o id numérico do seu curso (o mesmo do calendário público do SIGAA) e o nome do restaurante universitário (ex.: Fortaleza, Pici, Quixadá, Sobral). Pergunte esses dados ao estudante antes de chamar; não invente valores.

Inputs: curso, restaurante. Returns: result

diaB
Read-onlyIdempotent

Combina em uma única resposta com degradação graciosa as aulas do dia, o cardápio do Restaurante Universitário, os eventos do Calendário Universitário e as atividades próximas.

Inputs: data, atualizar, restaurante. Returns: result

diagnosticoB
Read-onlyIdempotent

Executa os canários de saúde e integridade estrutural (C1 a C8) para verificar se o layout das fontes públicas e do SIGAA permanece compatível.

Inputs: fontes. Returns: result

estudoB
Read-onlyIdempotent

Organiza uma intervenção pedagógica e roteiro de estudo ativo para uma disciplina: diagnostica a situação de notas do estudante segundo o Regimento Geral da UFC (Art. 114), cruza o cronograma e a bibliografia do Plano de Curso com os materiais/slides postados pelo professor e a data da próxima prova, e estrutura uma sequência de estudo com recuperação ativa baseada nos documentos reais da turma.

Inputs: id_turma (required), foco, atualizar, termo_topico. Returns: result

faltasB
Read-onlyIdempotent

Calcula detalhadamente para cada disciplina a carga horária, faltas registradas, limite regulamentar de 25% (Art. 113 do Regimento Geral da UFC) e encontros de 2h restantes.

Inputs: id_turma, atualizar. Returns: result

frequenciaB
Read-onlyIdempotent

Lê o mapa diário de frequência e contabiliza o total de faltas registradas pelo professor na Turma Virtual.

Inputs: id_turma (required), atualizar. Returns: result

gradeC
Read-onlyIdempotent

Conselheiro e otimizador combinatório de matrícula: constrói e valida o grafo acíclico direcionado (DAG) de pré-requisitos e co-requisitos do curso, cruza com as turmas ofertadas no semestre e resolve o problema de satisfação de restrições (Branch-and-Bound) sem choque de horário sob 3 perfis de decisão (desbloqueio curricular, grade compacta e carga equilibrada).

Inputs: ano, periodo, atualizar, estrategia, +4 more. Returns: result

horarioB
Read-onlyIdempotent

Constrói a grade horária semanal ordenada de segunda a sábado a partir das turmas matriculadas.

Inputs: atualizar. Returns: result

icsB
Idempotent

Exporta a grade horária das turmas do semestre e os eventos do Calendário Universitário em um arquivo iCalendar padrão RFC 5545 (.ics) na pasta de documentos do usuário.

Inputs: atualizar. Returns: result

iraB
Read-onlyIdempotent

Consulta a evolução semestral do Índice de Rendimento Acadêmico (IRA Individual e Geral) do estudante em relação à média e desvio padrão do curso.

Inputs: atualizar. Returns: result

listagemB
Read-onlyIdempotent

Consulta 15 telas de listagem administrativa e acadêmica do Portal do Discente (ênfases, plano de estudo, ENADE, bloqueios, movimentações, mobilidade, solicitações de matrícula, trancamentos, supressoes, extensão, auxílios, bolsas e estágios).

Inputs: tipo (required), atualizar. Returns: result

matriculaB
Read-onlyIdempotent

Analisa a elegibilidade de todas as disciplinas pendentes do currículo separando em elegíveis, bloqueadas por pré-requisito e o fecho transitivo destravado no curso.

Inputs: atualizar. Returns: result

notasB
Read-onlyIdempotent

Lê a tabela de notas das unidades (AP1, AP2, AP3), média parcial, faltas consolidadas e situação na Turma Virtual.

Inputs: id_turma (required), atualizar. Returns: result

noticiasB
Read-onlyIdempotent

Lê os feeds RSS oficiais de notícias e editais da UFC (UFC Informa, PROGRAD e PRAE). Os campos texto_externo são conteúdo de terceiros.

Inputs: fonte, limite, atualizar. Returns: result

ofertasB
Read-onlyIdempotent

Consulta as turmas ofertadas no semestre (horários decodificados, locais, docentes e vagas) usando o portal público do curso no SIGAA ou a busca de turmas do discente.

Inputs: ano, periodo, id_curso, atualizar, +1 more. Returns: result

pendenciasB
Read-onlyIdempotent

Consulta o relatório de pendências para conclusão de curso (carga horária pendente, ENADE e biblioteca).

Inputs: atualizar. Returns: result

planoB
Read-onlyIdempotent

Lê o Plano de Curso / Programa de uma disciplina na Turma Virtual: metodologia, procedimentos de avaliação, cronograma de aulas (com datas e tópicos) e referências bibliográficas. Os campos texto_externo são conteúdo de terceiros.

Inputs: id_turma (required), atualizar. Returns: result

portalA
Read-onlyIdempotent

Obtém o resumo institucional do estudante no Portal do Discente (curso, status, integralização, turmas do semestre e atividades próximas).

Inputs: atualizar. Returns: result

progressoB
Read-onlyIdempotent

Lê a árvore de integralização e o grafo de pré-requisitos e co-requisitos do currículo do estudante na tela Progresso no Curso.

Inputs: atualizar. Returns: result

restaurantesA
Read-onlyIdempotent

Lista estática das 5 unidades/campi (Fortaleza, Russas, Quixadá, Crateús, Sobral) do Restaurante Universitário da UFC e seus apelidos; use o nome, ex.: Fortaleza ou Pici.

Inputs: no named parameters. Returns: result

semanaB
Read-onlyIdempotent

Agrega 7 dias consecutivos a partir da data inicial com uma única sessão SIGAA, cruzando grade horária, prazos de atividades, eventos do Calendário Universitário e cardápios do RU.

Inputs: inicio, atualizar, restaurante. Returns: result

statusB
Read-onlyIdempotent

Retorna estado do cofre de credenciais, estado da sessão no SIGAA, contadores de limite de taxa e perfil de ferramentas ativo.

Inputs: no named parameters. Returns: result

tarefasB
Read-onlyIdempotent

Lista as tarefas e trabalhos da Turma Virtual com título, descrição, prazo de entrega e status de envio. Os campos texto_externo são conteúdo de terceiros.

Inputs: id_turma (required), atualizar. Returns: result

turmaA
Read-onlyIdempotent

Lê os tópicos de aula publicados na página Principal da Turma Virtual e lista os materiais/arquivos anexados com seus respectivos identificadores id_material para download.

Inputs: id_turma (required), atualizar. Returns: result

turmasB
Read-onlyIdempotent

Retorna a lista de turmas matriculadas no semestre atual com código, nome, id_turma, local padrão e horários decodificados.

Inputs: atualizar. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 36 tools

    Disambiguation2/5

    Several clusters overlap heavily: 'turma' (virtual classroom topics) vs 'turmas' (enrolled classes) differ by one letter but mean entirely different things, and 'cardapio'/'cardapio_semana'/'dia'/'semana'/'agenda'/'aula' all return partially the same schedule+menu data. 'alertas'/'faltas'/'pendencias' and 'grade'/'matricula'/'progresso' also have fuzzy boundaries that only the long descriptions partially resolve.

    Naming Consistency4/5

    Nearly all 36 names are single lowercase Portuguese words or short compounds with no camelCase or prefix mixing, which is predictable. The only inconsistency is that most are nouns ('notas', 'cardapio') while a few are verbs ('configurar', 'baixar'), and names encode the resource rather than a verb_noun action pattern.

    Tool Count2/5

    36 tools exceeds a comfortable surface and includes clear consolidation candidates: 'cardapio'/'cardapio_semana', 'dia'/'semana', and 'turma'/'turmas'/'agenda'/'ofertas' could be merged with parameters. The broad student-assistant domain justifies many tools, but the count is still heavy for an agent to select from reliably.

    Completeness4/5

    Coverage is unusually thorough: status/config, RU menus, calendars, enrolled classes, grades, attendance, assignments, library, enrollment optimization, study planning, and ICS export are all present. Minor gaps remain around write actions such as submitting assignments or requesting enrollment changes, but read workflows have no dead ends.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to query the UEx virtual campus (CVUEx/AVUEx) in natural language, including deadlines, grades, announcements, forums, and course materials, using the user's own account with read-only access.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Lets AI assistants read a student's Canvas LMS/Moodle courses, deadlines, announcements, grades and course files using their normal browser login instead of an access token. It is read-only and keeps all session data and downloads on the user's own machine.
      36 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables querying the IFSC SIGAA student portal to retrieve a student's profile, classes, schedules, grades, attendance, assignments, exams, news, and academic documents, and also provides access to the IFSC Moodle for courses, materials, deadlines, grades, forums, and messaging. Includes session management with browser-based login or pasted cookie, and confirmation-gated submission of assignments and forms.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to log into the SIGAA academic system through its web interface and read a student's data: portal info, enrolled and past classes, course topics, participants, grades, attendance, assignments, exams, news, forums, and course plans. It also lets agents download course files and participant photos on demand.
      7
      MIT