Back to Browse

Study Notes MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

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

10.0
Low Risk10.0Low Risk

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.

file_system

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Caminho absoluto da pasta de estudos (anotações, PDFs e código)Optional

Environment variable: NOTES_DIR

false desliga a busca e a leitura de PDFs (padrão: true)Optional

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 GitHub

From the project's GitHub README.

study-notes-mcp

npm test

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:linha ou arquivo, 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 comumO que costuma faltarAqui
Servidor de arquivos genéricobusca por assunto, fonte com linha ou página, cuidado com o conteúdo lidobusca híbrida, arquivo:linha / arquivo, p. N, proteções contra vazamento e prompt injection
MCP de notas ou de Obsidianleitura de PDF por página; funcionar sem o app abertoqualquer 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 vetorialo 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ê pedeO 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 aparecebuscar_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ídamarcar_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

TipoNomeO que faz
🔧 Toollistar_modulosLista os módulos (subpastas de NOTES_DIR)
🔧 Toollistar_arquivosMostra 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
🔧 Toolbuscar_materialBusca por nome exato ou por pergunta em anotações, PDFs e código, com filtro por tipo e por módulo
🔧 Tooller_materialLê uma anotação, um arquivo de código ou páginas de um PDF
🔧 Toolregistrar_duvidaSalva uma dúvida para revisar depois
🔧 Toolresolver_duvidaMarca uma dúvida como resolvida, sem apagá-la do histórico
🔧 Toolmarcar_aula_concluidaMarca uma aula como concluída
🔧 Toolver_estudosMostra as dúvidas pendentes e as aulas concluídas
📄 Resourceestudos://duvidas, estudos://progressoOs mesmos dados em JSON, para anexar ao chat
📄 Resourceestudos://indiceEstado da busca por significado: se está ligada, o progresso da indexação e o último erro
💬 Promptgerar_quiz, plano_de_revisaoQuiz sobre um módulo e plano de revisão da semana

Saiba mais

DocumentoO que tem
Clientes testadosComo configurar no Claude Code e no Codex, e o que funciona em cada cliente
ConfiguraçãoVariáveis, tipos de arquivo, .studynotesignore, notas do Obsidian, PDFs, usar em todos os projetos ou só num, atualizar
Busca por significadoComo ligar, como funciona e quanto melhora a busca
Segurança e privacidadeO que sai do seu computador, custos e as proteções contra vazamento e prompt injection
Problemas comunsSintomas e soluções
Entendendo o códigoEstrutura, ordem de leitura e o caminho de uma busca, para quem quer aprender a construir um servidor MCP
ContribuindoRodar a partir do código-fonte, scripts, testes e pull requests

Licença

ISC

Reviews

No reviews yet

Be the first to review this server!