Skip to content

Releases: CaioCastro1/usp-mcp

v1.1.0 — questionário, links no texto, e a chave em um passo

Choose a tag to compare

@JoaoPedroBPG JoaoPedroBPG released this 18 Sep 12:48
de4c0e8

Primeira leva depois da publicação. Nada do que existia mudou de nome ou de formato: tudo aqui é acréscimo ou conserto, e quem está na v1.0.0 pode atualizar sem mexer em nada.

Novidades

Questionário agora tem resposta. No Moodle, atividade e questionário são objetos diferentes, e até aqui só o primeiro era tratado: quem perguntasse sobre um questionário recebia "não passa por aqui". A ferramenta questionarios responde as três perguntas que ficavam sem resposta: já fiz, quantas tentativas sobram, e fechou sem eu ter feito. É leitura; abrir ou responder tentativa continua recusado.

O material lista os links que o professor põe no meio do texto. Link solto dentro de um bloco de texto da página não saía, e quem perguntasse pelos slides podia ouvir que não havia nenhum, com os slides linkados ali.

O assistente passa a saber que existe uma capacidade desligada. A escrita de entrega continua desligada por padrão, e agora o servidor conta que ela existe, o que custa e como se liga, sem pôr nada de novo para ser chamado.

Obter a chave do e-Disciplinas ficou de um passo. O script abre a página sozinho e fica de vigia: assim que você copia o endereço do link, ele segue sem precisar de aviso. Copiar a coisa errada deixou de custar uma rodada.

Consertos

Duas leituras de questionário que expunham enunciado e tentativa em curso entraram na lista de recusa permanente. O assistente tratava quem clona o repositório como mantenedor, e agora o padrão é sessão de uso. O canário da higienização comparava duas capturas diferentes. E a documentação afirmava que um caminho de envio de mensagem estava liberado quando ele está recusado desde 31/08, errando para o lado permissivo.

Decidido e não feito

Enviar mensagem pelo Moodle: não. Ler mensagem não reabre decisão nenhuma; enviar reabre, e contradiz a única recusa que o desenho da escrita declarou inegociável, que é não escrever em nome de quem não está na conversa.

Ainda não verificado contra dado real

O conserto dos links no texto está correto por leitura do código e por teste com dado montado, e nenhuma captura que o projeto tem reproduz o caso. Há um teste que reprova no dia em que uma captura com esse formato entrar. A ferramenta de questionário depende de campos que a conta de aluno pode não receber, e degrada declarando o que não conseguiu ver.


Interface pública desde a v1.0.0: ferramentas do Moodle 10 → 11, lista de permitidas 11 → 13, recusa permanente 38 → 40.

O detalhe está no CHANGELOG.md; o porquê de cada escolha, no §9 do SPEC1.md.

v1.0.0 — a primeira versão pública

Choose a tag to compare

@CaioCastro1 CaioCastro1 released this 17 Sep 17:07
acd0899

Ferramentas MCP para perguntar em português sobre a vida acadêmica na USP, a partir do seu assistente. Projeto não-oficial, sem vínculo com a Universidade de São Paulo.

O que dá para perguntar

Bandejão o que tem hoje, na sexta ou na semana inteira, nos quatro RUs da Cidade Universitária, com horário e preço
e-Disciplinas suas matérias, o que vence essa semana, material da disciplina, download de arquivo, o que você já entregou, o que ficou para trás, notas lançadas, avisos do professor e o que mudou desde ontem
JupiterWeb créditos, carga horária, ementa e pré-requisitos pela sigla da disciplina

Bandejão e JupiterWeb funcionam para qualquer pessoa, sem credencial. O e-Disciplinas mostra as suas disciplinas, e para isso precisa de uma chave pessoal que só você obtém — ela nunca sai do seu computador.

Como instalar

O README.md tem os dois caminhos: um prompt para colar no Claude Code, que instala e configura sozinho, e o passo a passo manual para quem prefere ver o que está acontecendo. Precisa de Python 3.11 ou mais novo, e funciona em Mac e Linux.

O que ele não responde, e por quê

Histórico escolar, saldo do RUCard, horário, sala e vagas ficam de fora — por falta de caminho público, não por falta de trabalho. O README.md explica caso a caso.

Duas garantias que valem ler antes de instalar: tudo é somente leitura por padrão, e o único caminho de escrita que existe (entregar tarefa) precisa de uma variável de ambiente e de uma confirmação declarada a cada chamada. Sua credencial não sai da sua máquina.

Achou um erro?

A USP muda os sistemas dela sem avisar ninguém, e quando isso acontece a resposta para de bater. É o relato mais útil que este projeto pode receber: https://github.com/CaioCastro1/usp-mcp/issues. Nunca cole o valor do seu token.