mcp-perfil

Currículo + portfólio vivo: um servidor MCP (Model Context Protocol) que expõe seu perfil profissional como ferramentas consumíveis por agentes de IA (Claude Code, Claude Desktop, Cursor, VS Code, qualquer cliente MCP), e que também serve uma landing page bonita e um PDF de currículo bilíngue (PT/EN) — tudo gerado na hora, direto de um único arquivo de dados (profile.json).

Este README é um guia de replicação: siga os passos para transformar isto no seu perfil, do zero ao deploy.

O que você ganha

• Servidor MCP (get_experiences, get_skills, get_projects, get_summary, get_recommendations, get_github_repos, get_github_repo) — qualquer agente de IA pode consultar seu histórico profissional em tempo real.

• Landing page bilíngue (PT/EN), com modo "view as agent" (texto puro para LLMs), projetos puxados ao vivo do GitHub (com cache), e uma seção "para agentes" com o comando de instalação do seu MCP pronto para copiar.

• Currículo em PDF, gerado na hora a partir dos mesmos dados, nos dois idiomas, disponível em /resume e /resume?lang=en.

• Testes automatizados (npm test) que travam a integridade dos dados: se você adicionar uma experiência/projeto sem a tradução em inglês correspondente, a suíte falha antes de você publicar.

• CI no GitHub Actions, rodando os testes a cada push/PR.

Related MCP server: Pavan Madduri — Personal Knowledge MCP Server

1. Fork e instalação

git clone https://github.com/<seu-usuario>/mcp-perfil.git
cd mcp-perfil
npm install

2. Edite profile.json com os seus dados

Esse arquivo é a única fonte de verdade — landing page, PDF e ferramentas MCP leem dele. Campos principais:

Troque também os assets em public/:

• public/favicon.jpg — ícone do site

• public/portrait.mp4 — vídeo curto do seu rosto, usado no efeito de pontos do hero (mudo, alguns segundos, de preferência fundo neutro — o efeito faz a extração de silhueta automaticamente)

E o e-mail de contato: procure por jeansaantos89@gmail.com em src/landing-page.js e src/resume.js e troque pelo seu.

3. Traduza para inglês (src/i18n.js)

A página e o PDF renderizam em inglês por padrão e trocam para português no clique do botão EN/PT. As traduções vivem em dicionários PT→EN dentro de src/i18n.js (ROLES, BULLETS, PROJECTS, TITLES, TERMS, etc.) e são aplicadas pela função en().

Depois de editar profile.json, rode os testes — eles apontam exatamente o que ainda falta traduzir:

npm test

Se aparecer missing EN translation for ..., adicione a entrada correspondente no dicionário certo em i18n.js (o próprio erro já mostra o texto que falta).

4. Rode localmente

npm run start:http

Abre em http://localhost:3000. Edite profile.json e dê refresh para ver as mudanças — não há build, tudo é renderizado a cada request.

Para usar via stdio (Claude Desktop/Code local, sem subir servidor HTTP):

npm start

5. Deploy gratuito (Render)

1. Suba o fork no GitHub.

2. Crie uma conta em render.com (login com GitHub, sem cartão).

3. New + → Web Service → selecione o repositório.

4. Configure:

   • Runtime: Node

   • Build Command: npm install

   • Start Command: npm run start:http

   • Instance Type: Free

5. Depois do deploy, a URL pública (ex: https://seu-app.onrender.com/mcp) já pode ser usada em qualquer cliente MCP compatível com Streamable HTTP.

O plano free do Render "dorme" após 15 min de inatividade — a primeira requisição após esse período pode levar ~1 min para responder. Para evitar isso, configure um cronjob externo (ex: cron-job.org, grátis) batendo a cada 10 min em https://seu-app.onrender.com/health — essa rota responde um "ok" mínimo, pensada exatamente para pingers de keep-alive (a página completa é grande demais para a maioria desses serviços). Mantendo um único serviço free sempre ativo você fica dentro da cota de 750h de instância gratuita por mês do Render; se tiver outro serviço free na mesma conta, as horas somam e podem estourar o limite.

6. Conecte num cliente MCP

Com o servidor rodando (local ou no Render), a própria landing page mostra o comando de instalação pronto na seção "for agents", para Claude Code, Cursor, VS Code e curl. Exemplo (Claude Code):

claude mcp add --transport http perfil https://seu-app.onrender.com/mcp

Estrutura

profile.json          — todos os dados do perfil (a única fonte de verdade)
public/                — favicon e vídeo do retrato
src/
  create-server.js     — tools/resources do MCP, leitura do profile.json e da API do GitHub
  server.js            — entrada stdio (uso local em clientes MCP)
  http-server.js        — entrada HTTP: landing page, PDF do currículo, /health, e /mcp (Streamable HTTP)
  landing-page.js       — renderiza a landing page (HTML+CSS+JS inline, sem build step)
  resume.js             — gera o PDF do currículo (pdfkit), bilíngue
  i18n.js               — dicionários de tradução PT→EN e textos de UI
tests/                 — node --test: integridade de tradução, estrutura da página, PDF, rotas HTTP
.github/workflows/      — CI rodando os testes a cada push/PR

Rodando os testes

npm test

Cobre: toda experiência/projeto/formação tem tradução em inglês registrada, a página renderiza um card/entrada por item do profile.json (sem hardcode de conteúdo), o PDF do currículo é gerado com sucesso nos dois idiomas, e as rotas HTTP respondem como esperado — incluindo um teste de regressão para a proteção contra path traversal na rota de arquivos estáticos.

Licença

MIT — use, copie, modifique e redistribua à vontade, inclusive comercialmente, só mantendo o aviso de copyright.