Repository navigation
v1.0.0
Primeira versão publicada.
Instalação: npx -y study-notes-mcp@latest. Veja o passo a passo no README.
Tools, prompts e resources
buscar_material: busca por nome exato e, comSEMANTIC_SEARCH=true, por significado. As duas buscas são unidas (Reciprocal Rank Fusion), e cada resultado cita arquivo, linha e página.ler_material: lê anotações, código e PDFs por página. Em notas do Obsidian, mostra para onde cada[[link]]aponta.listar_modulos, incluindo os módulos dentro de outra pasta (como num repositório de curso clonado).registrar_duvida,resolver_duvida,marcar_aula_concluidaever_estudos.- Prompts
gerar_quiz(com autocompletar do módulo e busca pelo número ou trecho do nome) eplano_de_revisao, ambos pedindo a fonte de cada resposta. - Resources
estudos://duvidaseestudos://progresso.
Material
- Anotações (
.md,.txt), PDFs com texto e código (.ts,.js,.pye outros). - Arquivo
.studynotesignore, no formato do.gitignore, para excluir pastas e arquivos. - Busca por significado local, com o modelo
multilingual-e5-small: sem chave de API, textos repetidos calculados uma vez só.
Segurança
- Lista fechada de extensões, bloqueio de arquivos ocultos, de
../e de symlinks para fora da pasta. - Segredos trocados por
[REDACTED], alertas de prompt injection e conteúdo delimitado como dado não confiável. - Recusa igual para arquivos bloqueados que existem ou não, e mensagens de erro sem caminhos absolutos.
- Gravação atômica das dúvidas, do progresso e do índice, com novas tentativas no Windows; um arquivo ilegível nunca é sobrescrito.
Requisitos
- Node.js 22.18 ou mais novo.
Clientes testados
- VS Code com GitHub Copilot, Claude Code e Codex. Detalhes em clientes testados.