convez.ai
MCP ServerAutomaçãoIntermediário
internship-app1

Internship MCP Server

internship-app1/internship-mcp-server

Agente autônomo para buscar e aplicar a estágios com currículo customizado

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que transforma qualquer agente Claude em um assistente de candidatura a estágios. Busca vagas frescas, filtra por suas skills, customiza currículos automaticamente (com compilação local de PDF via pdflatex), monta pacotes de aplicação completos e prefill formulários ATS via Playwright — você apenas revisa e submete.

Instalação

$npx convez-ai internship-app1/internship-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
25%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Buscar e filtrar vagas de estágio relevantes automaticamente
  • Gerar currículos customizados por vaga com bullets otimizados
  • Preencher formulários ATS e applications de forma autônoma
  • Manter dados sensíveis (PII, vistos, EEO) criptografados localmente

Veredito

Ferramenta bem arquitetada que delega inteligentemente a candidatura a estágios para agentes, mantendo você no controle final. Repousa em princípios sólidos (raciocínio no agente, PII local, compilação local por padrão) e oferece múltiplas opções de deploy — uvx é acessível, Docker é reproduzível. Ideal para quem quer automação real sem terceirizar dados.

README

A tradução para o português deste README ainda está na fila.

internship-mcp

A vendor-neutral MCP server that turns any MCP-capable agent (Claude Code, Cursor, Codex, Windsurf, Cline) into an internship apply agent: pull fresh internship postings, deterministically prefilter them against your skills, tailor your resume per job (your agent writes the bullets, pdflatex compiles the PDF locally), assemble a fully-filled application packet, and prefill ATS forms via the Playwright MCP — while you review and hit submit.

Design principles

  • Your agent is the brain. This server never calls a model. Skill extraction, ranking, bullet rewriting, and answers are your agent's own reasoning over deterministic data.
  • Your PII stays on your machine. Citizenship, visa, EEO, and demographic answers live in a Fernet-encrypted local file and flow only into the application forms you approve — never to our backend.
  • Compile is local by default. The Docker image bakes pdflatex; the backend compile endpoint is a rate-limited fallback for the no-Docker quick start.

Quick start

  1. Sign in at the Internship Matcher web app and generate an API key on the /developer page.
  2. Pick a tier:

Just exploring? Hosted endpoint (zero install — job search & fit scoring only)

Add a custom connector / remote MCP server pointing at:

https://internshipmatcher.com/mcp?key=im_live_...

(Clients that support headers can send X-API-Key instead of the ?key= param.) The hosted tier covers discovery; applying needs the full agent below.

Full apply agent — uvx (recommended; no Docker, no clone)

{
  "mcpServers": {
    "internship": {
      "command": "uvx",
      "args": ["internship-mcp"],
      "env": { "INTERNSHIP_API_KEY": "im_live_..." }
    },
    "playwright": { "command": "npx", "args": ["@playwright/mcp@latest"] }
  }
}

Resume compiling: during onboarding the agent asks you to choose — install pdflatex locally for unlimited compiles (recommended):

# macOS
brew install --cask basictex && sudo tlmgr update --self && sudo tlmgr install enumitem titlesec parskip microtype
# Debian/Ubuntu
sudo apt install texlive-latex-extra
# Windows: install MiKTeX from https://miktex.org

…or skip the install and compile on our servers (15 resumes/week). COMPILE=auto (the default) picks local automatically whenever pdflatex is present.

Docker (advanced — pinned TeX Live + OCR baked in, fully reproducible)

{
  "mcpServers": {
    "internship": {
      "command": "docker",
      "args": ["run", "-i", "--rm",
               "-v", "internship-home:/root/.internship-agent",
               "-e", "INTERNSHIP_API_KEY",
               "ghcr.io/internship-app1/internship-mcp-server:latest"],
      "env": { "INTERNSHIP_API_KEY": "im_live_..." }
    },
    "playwright": { "command": "npx", "args": ["@playwright/mcp@latest"] }
  }
}

Config file locations: Claude Code .mcp.json · Cursor ~/.cursor/mcp.json · Codex ~/.codex/config.toml · Windsurf ~/.codeium/windsurf/mcp_config.json · Cline cline_mcp_settings.json.

  1. Ask your agent something like: "Set up my internship profile, then find new postings from the last 3 days that fit my resume at ~/resume.pdf, tailor my resume for the top 5, and prefill the applications for my review."

Environment

VarDefaultMeaning
INTERNSHIP_API_KEY(required)per-user key from /developer
INTERNSHIP_API_URLproduction URLbackend base URL
INTERNSHIP_HOME~/.internship-agentencrypted profile, tracker DB, PDFs
COMPILEautolocal / remote / auto (local if pdflatex present)
INTERNSHIP_PROFILE_KEY—fallback Fernet key when no OS keyring exists
MAX_AUTO_SUBMITS10v2 per-session auto-submit cap

Development

pip install -e ".[dev]"
pytest                 # unit tests
pytest -m parity       # compile parity vs the backend core (needs pdflatex)
npx @modelcontextprotocol/inspector uvx --from . internship-mcp
docker build -t internship-mcp .

Safety & terms

v1 is assisted: the agent prefills, you review and submit. Auto-submit (v2) is opt-in, dry-run by default, capped per session, and blocked by any low-confidence field. Subjective questions ("why us?", "proudest achievement") are always asked to you and saved in your local answer bank — never fabricated. EEO questions default to "Decline to self-identify" unless you set them. You are responsible for the accuracy of every application and for complying with each job board's terms of service. Every submission is logged locally with the exact answers used.

Ver o original no GitHub

Bom para

Relacionados