Internship MCP Server
internship-app1/internship-mcp-server
Agente autônomo para buscar e aplicar a estágios com currículo customizado
Ver no GitHubServidor 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-server1 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
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
- Sign in at the Internship Matcher web app and generate an API key on the
/developerpage. - 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.
- 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
| Var | Default | Meaning |
|---|---|---|
INTERNSHIP_API_KEY | (required) | per-user key from /developer |
INTERNSHIP_API_URL | production URL | backend base URL |
INTERNSHIP_HOME | ~/.internship-agent | encrypted profile, tracker DB, PDFs |
COMPILE | auto | local / remote / auto (local if pdflatex present) |
INTERNSHIP_PROFILE_KEY | — | fallback Fernet key when no OS keyring exists |
MAX_AUTO_SUBMITS | 10 | v2 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.