recap-mcp

Recap

Seu gerente de projetos com IA. Markdown simples. Local-first. Open source.

Recap é um servidor MCP que dá ao Claude memória persistente dos seus projetos em andamento. Buscas de emprego, projetos paralelos, metas de aprendizado, esforços de escrita, qualquer coisa em que você trabalhe por semanas ou meses. Seus dados ficam como arquivos markdown simples em uma pasta que você controla.

Por que Recap

O Claude esquece entre conversas. Você gasta os primeiros cinco minutos de cada chat reexplicando no que está trabalhando, o que decidiu da última vez e o que está pendente. Recap resolve isso.

• Local-first: seu workspace é uma pasta de arquivos markdown. Nada sai da sua máquina.
• Markdown simples: abra no VS Code, Obsidian, vim, qualquer coisa.
• Open source: licença MIT, sem vendor lock-in.
• Focado em projetos, não em blocos: estruturado em torno de projetos, tarefas, sessões e notas, não em despejos de memória opacos.
• Onze ferramentas focadas: sem excessos, sem inchaço.

Instalação

Requer Node.js 18+.

npx recap-mcp init

Esse único comando:

1. Cria uma pasta de workspace em ~/recap-workspace/
2. Adiciona o Recap à configuração do Claude Desktop
3. Faz backup de qualquer configuração existente do Claude em .bak

Depois, saia do Claude Desktop, reabra e diga "oi". O Recap vai te guiar pelo seu primeiro projeto.

As onze ferramentas

Ferramenta	Finalidade
briefing	Execute no início da sessão. Carrega o status do workspace, projetos ativos e atividade recente.
project_list	Liste projetos, filtre por status.
project_create	Inicie um novo projeto, opcionalmente com base em um template.
project_brief	Carregue o contexto completo de um projeto (descrição, tarefas abertas, sessões recentes).
task_add	Adicione uma tarefa com prioridade, data de vencimento e notas opcionais.
task_list	Liste tarefas de um projeto, filtráveis por status.
task_update	Altere status, prioridade, data de vencimento, notas ou título.
task_delete	Remova uma tarefa.
session_log	Salve uma entrada de sessão estruturada: o que foi feito, decisões, próximos passos.
quick_note	Adicione uma nota com data e hora a um projeto.
search	Busca difusa com ranqueamento em todo o workspace.

Templates

O Recap vem com seis templates iniciais:

• generic (em branco)
• job-search
• side-project
• learning
• writing
• moving

Passe --template para project_create (ou peça ao Claude para fazer isso) para iniciar um projeto com tarefas iniciais e um arquivo de conhecimento.

Estrutura do workspace

~/recap-workspace/
├── .recap/
│   └── config.json
├── projects/
│   └── job-search-2026/
│       ├── project.md
│       ├── tasks.md
│       ├── notes.md
│       ├── sessions/
│       │   └── 2026-05-20.md
│       └── knowledge/
│           └── starter.md
└── archived/

Markdown simples com frontmatter YAML. Você pode cd nele e git init se quiser controle de versão. Abra no Obsidian se quiser um visual mais agradável.

Configuração

O caminho do workspace tem como padrão ~/recap-workspace/. Substitua com:

export RECAP_WORKSPACE_PATH=/path/to/your/workspace

Ou passe --workspace para recap-mcp init.

Outras configurações ficam em .recap/config.json:

{
  "version": "0.1.0",
  "briefing": { "recent_days": 14, "max_active_projects": 5 },
  "search": { "max_results": 10 }
}

Solução de problemas

Execute npx recap-mcp doctor para diagnósticos.

Se o Claude Desktop não detectar o Recap após a instalação:

1. Certifique-se de sair completamente do Claude Desktop (não apenas fechar a janela).
2. Verifique se ~/recap-workspace/ existe.
3. Verifique se a configuração do Claude Desktop tem a entrada mcpServers.recap.

Privacidade

O Recap roda inteiramente na sua máquina. Não há telemetria, nem analytics, nem chamadas remotas. Seus projetos, tarefas, notas e registros de sessão nunca saem do seu computador.

Licença

MIT. Veja LICENSE.

Status

v0.1.0. Fase inicial. Feedback e problemas são bem-vindos em https://github.com/shivam-singh-git/recap-mcp/issues.