Server data from the Official MCP Registry
Busca nas suas anotações, PDFs e código citando a fonte; dúvidas, progresso e quizzes.
About
Busca nas suas anotações, PDFs e código citando a fonte; dúvidas, progresso e quizzes.
Security Report
Valid MCP server (3 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.
4 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: NOTES_DIR
Environment variable: INCLUDE_PDF
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"study-notes-mcp": {
"command": "npx",
"args": [
"-y",
"study-notes-mcp@1.4.0"
],
"env": {
"NOTES_DIR": "your-notes-dir-here",
"INCLUDE_PDF": "your-include-pdf-here"
}
}
}
}Some servers take additional arguments. See the repository for details.
Documentation
View on GitHubFrom the project's GitHub README.
study-notes-mcp
Servidor MCP (Model Context Protocol) que deixa o assistente de IA do seu editor (Copilot, Claude...) consultar o seu material de estudo: anotações, PDFs das aulas e código. Ele responde citando de onde tirou cada informação, registra dúvidas, acompanha o progresso e monta quizzes e planos de revisão.
Você: O que eu anotei sobre chunking?
Copilot: Chunking divide documentos grandes em trechos menores antes de gerar
os embeddings (modulo03/aula-rag.pdf, p. 2). Nas suas notas, o tamanho
usado foi de ~800 caracteres (modulo03/rag.md:14).
- Respostas com fonte: cada informação vem com
arquivo:linhaouarquivo, p. N, para você conferir. - Acha pelo assunto: com a busca por significado ligada, "como cortar documentos grandes?" encontra a nota sobre chunking, mesmo sem a palavra.
- Local e gratuito: roda no seu computador, sem chave de API, sem Ollama e sem banco de dados.
- Seguro com conteúdo não confiável: mascara segredos e avisa sobre prompt injection nos arquivos lidos.
- Funciona com qualquer pasta: anotações em Markdown, PDFs das aulas, código e notas do Obsidian.
Por que este servidor
Cada parte já existe em algum lugar; a combinação é que é difícil de achar:
| Alternativa comum | O que costuma faltar | Aqui |
|---|---|---|
| Servidor de arquivos genérico | busca por assunto, fonte com linha ou página, cuidado com o conteúdo lido | busca híbrida, arquivo:linha / arquivo, p. N, proteções contra vazamento e prompt injection |
| MCP de notas ou de Obsidian | leitura de PDF por página; funcionar sem o app aberto | qualquer pasta: Markdown, PDFs, código e notas do Obsidian |
| MCP de busca semântica (RAG) | rodar sem Ollama, sem chave de API e sem banco vetorial | o modelo de embeddings roda dentro do servidor: só o npx |
E, além disso, um fluxo de estudo (dúvidas, progresso, quiz e plano de revisão que citam a fonte) e uma publicação verificável: cada versão sai do GitHub com provenance e só é liberada com 2FA.
O servidor não traz conteúdo nenhum. Ele busca na sua pasta de estudos. Cada pessoa aponta para a própria pasta, e ninguém acessa os arquivos de ninguém.
Instalação (passo a passo)
1. Pré-requisitos: Node.js 22.18 ou mais novo (confira com node -v) e o VS Code com o GitHub Copilot (o plano Free funciona). Também funciona no Claude Code, no Codex e em outros clientes MCP.
2. Escolha a pasta de estudos. Ela vira o NOTES_DIR, e cada subpasta de primeiro nível vira um módulo. Não precisa reorganizar nada: aponte para onde você já guarda o material. Se um módulo estiver dentro de outra pasta, como num repositório de curso clonado, use o caminho completo (repo-do-curso/modulo03-mcp).
Estudos/
modulo01-fundamentos/ ← suas anotações (.md, .txt)
modulo03-mcp/ ← PDFs das aulas
repo-do-curso/ ← código (.ts, .js, .py)
3. Configure o VS Code. Abra Cmd+Shift+P (Mac) ou Ctrl+Shift+P (Windows/Linux) → MCP: Open User Configuration e adicione dentro de "servers":
{
"servers": {
"study-notes-mcp": {
"type": "stdio",
"command": "npx",
"args": ["-y", "study-notes-mcp@latest"],
"env": {
"NOTES_DIR": "/Users/seu-usuario/Documents/Estudos"
}
}
}
}
O caminho precisa ser absoluto. No Windows, use /: "C:/Users/seu-usuario/Documents/Estudos". Não precisa baixar nada: o npx busca o pacote no npm na primeira vez, o que leva alguns segundos.
4. Inicie: MCP: List Servers → study-notes-mcp → Start Server. Em Show Output, deve aparecer Discovered 8 tools.
5. Use: abra o Copilot Chat no modo Agent e pergunte algo sobre o seu material. Na primeira vez, o VS Code pede permissão para cada tool: clique em Allow.
Algo deu errado? Veja os problemas comuns.
⚠️ Material do curso é seu, não do repositório. PDFs, slides e gravações costumam ter direitos autorais: mantenha-os só na sua pasta local e nunca faça commit deles em repositório público.
Exemplos de uso
| Você pede | O servidor faz |
|---|---|
O que eu anotei sobre embeddings? | buscar_material em anotações, PDFs e código |
Busque "chunking" só nos PDFs e leia a página onde aparece | buscar_material → ler_material com as páginas |
Registre uma dúvida no modulo03: quando usar resource em vez de tool? | registrar_duvida |
Marque a aula 05 do modulo03 como concluída | marcar_aula_concluida |
Quais dúvidas eu ainda tenho pendentes? | ver_estudos |
Que anotações e PDFs existem no módulo 3? | listar_arquivos |
O que eu tenho no material sobre o módulo 4? | listar_arquivos (num módulo grande, o panorama das aulas) → ler_material nos READMEs |
Os prompts prontos aparecem digitando / no chat: /mcp.study-notes-mcp.gerar_quiz monta um quiz sobre um módulo, com a fonte de cada resposta, e /mcp.study-notes-mcp.plano_de_revisao monta a revisão da semana a partir das suas dúvidas. No quiz, o módulo pode ser o número (3), um trecho do nome (mcp) ou o caminho da pasta. Se ficar vazio ou houver mais de uma pasta parecida, o assistente pergunta qual você quer. Quem escreve o quiz e o plano é o modelo do chat: o servidor entrega o pedido e o material.
O que o servidor oferece
| Tipo | Nome | O que faz |
|---|---|---|
| 🔧 Tool | listar_modulos | Lista os módulos (subpastas de NOTES_DIR) |
| 🔧 Tool | listar_arquivos | Mostra o que existe num módulo: os arquivos, com tipo e tamanho, ou, acima de 100, as subpastas com a contagem e o começo do README de cada uma |
| 🔧 Tool | buscar_material | Busca por nome exato ou por pergunta em anotações, PDFs e código, com filtro por tipo e por módulo |
| 🔧 Tool | ler_material | Lê uma anotação, um arquivo de código ou páginas de um PDF |
| 🔧 Tool | registrar_duvida | Salva uma dúvida para revisar depois |
| 🔧 Tool | resolver_duvida | Marca uma dúvida como resolvida, sem apagá-la do histórico |
| 🔧 Tool | marcar_aula_concluida | Marca uma aula como concluída |
| 🔧 Tool | ver_estudos | Mostra as dúvidas pendentes e as aulas concluídas |
| 📄 Resource | estudos://duvidas, estudos://progresso | Os mesmos dados em JSON, para anexar ao chat |
| 📄 Resource | estudos://indice | Estado da busca por significado: se está ligada, o progresso da indexação e o último erro |
| 💬 Prompt | gerar_quiz, plano_de_revisao | Quiz sobre um módulo e plano de revisão da semana |
Saiba mais
| Documento | O que tem |
|---|---|
| Clientes testados | Como configurar no Claude Code e no Codex, e o que funciona em cada cliente |
| Configuração | Variáveis, tipos de arquivo, .studynotesignore, notas do Obsidian, PDFs, usar em todos os projetos ou só num, atualizar |
| Busca por significado | Como ligar, como funciona e quanto melhora a busca |
| Segurança e privacidade | O que sai do seu computador, custos e as proteções contra vazamento e prompt injection |
| Problemas comuns | Sintomas e soluções |
| Entendendo o código | Estrutura, ordem de leitura e o caminho de uma busca, para quem quer aprender a construir um servidor MCP |
| Contribuindo | Rodar a partir do código-fonte, scripts, testes e pull requests |
Licença
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
