convez.ai
MCP ServerBusca & PesquisaIntermediário
mnoomnoo

Resume MCP Server

mnoomnoo/resume-mcp-server

Pesquisa e recuperação de informações em documentos de candidatura locais

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que fornece ao Claude acesso estruturado a documentos de candidatura (currículos, cartas de apresentação e materiais relacionados). Suporta .docx, .pdf, .md e .txt com busca por nome, empresa, habilidade, educação, projetos e texto completo, com hot-reload automático.

Instalação

$npx convez-ai mnoomnoo/resume-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
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 meses
Versão
release-3.0.2
Issues abertas
0
Contribuidores
1

Casos de uso

  • Assistente de IA consultando histórico profissional em tempo real
  • Busca contextual por habilidades ou experiências em coleção de currículos
  • Automação de seleção e análise de candidatos com acesso estruturado a documentos

Veredito

MCP server bem construído para acesso inteligente a documentos de candidatura. Implementação sólida com suporte a múltiplos formatos, 21 ferramentas especializadas e deploy Docker pronto para produção, ideal para quem precisa dar ao Claude acesso contextual a históricos profissionais.

README

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

resume-mcp-server

CI License: GPL v3 Python 3.12+ MCP PyPI resume-mcp-server MCP server

An MCP server for browsing and searching job application documents — resumes, cover letters, and related materials.

Supports .docx, .pdf, .md, and .txt files, including nested subdirectories.


Quick Start

Give Claude structured access to your resume collection. The server parses your documents on startup and exposes 21 tools for searching by name, company, skill, education, side project, or full text — with automatic hot-reload when files change.

Try it immediately with the included sample resumes:

pip install resume-mcp-server
RESUME_DIR=./sample_resumes resume-mcp-server

Then connect Claude Code:

claude mcp add resume-collection resume-mcp-server -e RESUME_DIR=$(pwd)/sample_resumes

For a persistent setup with Docker or your own documents, see Docker Deploy or Dev Environment.


Docker Deploy

The recommended way to run the server. Docker Compose exposes the server over HTTP so any AI client can connect to it.

1. Set your resume directory

Copy the example env file and set your documents path:

cp .env.example .env
# then edit RESUME_DIR_HOST in .env

2. Sync the image version (optional)

Stamp the image with the current pyproject.toml version:

python scripts/sync_version.py

3. Build and start

docker compose build resume-mcp
docker compose up -d

The server is now available at http://localhost:8001/mcp.

4. Connect your AI client

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "resume-collection": {
      "type": "http",
      "url": "http://localhost:8001/mcp"
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "resume-collection": {
      "type": "http",
      "url": "http://localhost:8001/mcp"
    }
  }
}

Claude Code:

claude mcp add resume-collection --transport http http://localhost:8001/mcp

To add it globally across all projects, add the following to ~/.claude.json instead:

{
  "mcpServers": {
    "resume-collection": {
      "type": "http",
      "url": "http://localhost:8001/mcp"
    }
  }
}

Stopping

docker compose down

Docker (stdio)

Run the image directly — no Compose needed — for MCP clients that use stdio transport (including Glama.ai and Claude Desktop):

docker run -i --rm -v /path/to/your/resumes:/resumes resume-mcp-server

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "resume-collection": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-v", "/path/to/your/resumes:/resumes", "resume-mcp-server"]
    }
  }
}

Dev Environment

For local development or running the server without Docker.

Prerequisites

Python 3.12+

Install

pip install .
# include test dependencies:
pip install ".[dev]"

Run

resume-mcp-server
# with a custom directory:
RESUME_DIR=/path/to/docs resume-mcp-server

Or create a .env file in the directory you run the server from:

# .env
RESUME_DIR=/path/to/docs
FASTMCP_PORT=8001

Then just run resume-mcp-server — the .env is loaded automatically. Variables already set in your shell or by the MCP client always take precedence over .env values.

Connect your AI client (stdio)

Claude Desktop:

{
  "mcpServers": {
    "resume-collection": {
      "command": "resume-mcp-server",
      "env": {
        "RESUME_DIR": "/path/to/your/resumes"
      }
    }
  }
}

If resume-mcp-server is not on your PATH, use the full path (e.g. ~/.venv/bin/resume-mcp-server).

Claude Code:

claude mcp add resume-collection resume-mcp-server -e RESUME_DIR=/path/to/your/resumes

uvx:

{
  "mcpServers": {
    "resume-collection": {
      "command": "uvx",
      "args": ["resume-mcp-server"],
      "env": {
        "RESUME_DIR": "/path/to/your/resumes"
      }
    }
  }
}

Configuration

Docker Compose (.env):

VariableDescription
RESUME_DIR_HOSTPath on your machine to the documents directory — mounted to /resumes inside the container
FASTMCP_PORTPort the HTTP server listens on (default 8001)
LOG_LEVELLogging verbosity: DEBUG, INFO, WARNING, ERROR (default INFO)

Local run (environment variables or .env):

VariableDefaultDescription
RESUME_DIR~/resumesDirectory scanned for documents
FASTMCP_TRANSPORThttp (local) / stdio (Docker image)Transport protocol (http or stdio)
FASTMCP_HOST0.0.0.0Bind address
FASTMCP_PORT8001Port the HTTP server listens on

A .env file in the working directory is loaded automatically on startup if present. Shell environment variables and values set by the MCP client always take precedence over .env values.

The server scans RESUME_DIR recursively on startup and reloads automatically when files change.

Document type inference

Types are inferred from filenames:

TypeFilename patterns
resumecontains resume
cover_lettercover letter, _cl., coverletter
application_materialinterview, study guide, why_, application question, job desc
othereverything else

MCP Tools

list_resume_summaries

List all resumes as lightweight identity records. Use this first to orient and pick a resume_id before fetching details — much more token-efficient than list_resumes.

No parameters.

Returns: id, first_name, last_name, email, phone_num for each resume.


list_resumes

List all documents, optionally filtered by type.

ParameterTypeDescription
doc_typestring (optional)resume, cover_letter, application_material, or other

get_resume

Return the full extracted text of a document.

ParameterTypeDescription
pathstringRelative path as returned by list_resumes

get_resume_profile

Get a resume's top-level fields (contact info, professional statement, education) without the nested work experience or badge skill lists. Prefer this over get_resume when you need structured contact data rather than raw text.

ParameterTypeDescription
resume_idstringResume ID from list_resume_summaries or search_resumes_by_name

search_resumes

Full-text search across all documents (case-insensitive), sorted by match count.

ParameterTypeDescription
querystringText to search for
doc_typestring (optional)Filter by type (same values as list_resumes)

search_resumes_by_name

Find resumes by person name (first or last name). Returns minimal identity fields — use the returned id with other tools to fetch full details.

ParameterTypeDescription
querystringName fragment to search for (case-insensitive, partial match)

Returns: id, first_name, last_name, email, phone_num.


search_resumes_by_skill

Find which resumes list a given badge skill. Returns resume identity and matched skill names — more token-efficient than list_resumes when filtering by skill.

ParameterTypeDescription
skillstringSkill title fragment to search for (case-insensitive, partial match)

Returns: id, first_name, last_name, matched_skills.


search_skills

Search badge skills (technologies, tools, languages) by title.

ParameterTypeDescription
querystringText to search for in skill titles (case-insensitive)

search_work_experiences

Search work experiences by company name, position title, or achievement description bullets. Each result includes a resume_id field identifying which resume the entry belongs to.

ParameterTypeDescription
querystringText to search for (case-insensitive)

list_work_experiences

List work experience entries, optionally scoped to a single resume and/or only current roles.

ParameterTypeDescription
resume_idstring (optional)Resume ID from list_resume_summaries
current_onlyboolean (optional)If true, return only roles where end_date is "Present"

get_work_experience

Get a single work experience entry with its achievement bullets.

ParameterTypeDescription
idstringWork experience ID from list_work_experiences

list_achievements

List all achievement bullets, optionally scoped to a single resume.

ParameterTypeDescription
resume_idstring (optional)Resume ID from list_resumes

get_achievement

Get a single achievement bullet by ID.

ParameterTypeDescription
idstringAchievement ID from list_achievements

search_achievements

Search achievement descriptions directly, returning only matching bullets with minimal parent context. More token-efficient than search_work_experiences when you only need matching bullets.

ParameterTypeDescription
querystringText to search for in achievement descriptions (case-insensitive)
resume_idstring (optional)Resume ID to scope the search to one resume

Returns: id, desc, company_name, position_title, work_experience_id, resume_id.


list_badge_skills

List all badge skills, optionally scoped to a single resume.

ParameterTypeDescription
resume_idstring (optional)Resume ID from list_resumes

get_badge_skill

Get a single badge skill by ID.

ParameterTypeDescription
idstringBadge skill ID from list_badge_skills

list_side_projects

List side projects (personal/portfolio projects, distinct from work experience) that demonstrate competency with specific technologies, optionally scoped to a single resume.

ParameterTypeDescription
resume_idstring (optional)Resume ID from list_resume_summaries

get_side_project

Get a single side project by ID, including the technologies it demonstrates.

ParameterTypeDescription
idstringSide project ID from list_side_projects

search_side_projects

Search side projects by name, description, or associated technology. Each result includes a resume_id field identifying which resume the project belongs to.

ParameterTypeDescription
querystringText to search for (case-insensitive)
resume_idstring (optional)Resume ID to scope the search to one resume

search_side_projects_by_technology

Find side projects that demonstrate competency with a given technology.

ParameterTypeDescription
technologystringTechnology/skill name fragment to search for (case-insensitive, partial match)

Returns: id, name, description, matched_technologies, resume_id.


list_education

List education entries (degree, institution, year, and relevant coursework/competencies), optionally scoped to a single resume.

ParameterTypeDescription
resume_idstring (optional)Resume ID from list_resume_summaries

get_education

Get a single education entry by ID, including its competencies.

ParameterTypeDescription
idstringEducation entry ID from list_education

search_education

Search education entries by institution, degree, or competency. Each result includes a resume_id field identifying which resume the entry belongs to.

ParameterTypeDescription
querystringText to search for (case-insensitive)
resume_idstring (optional)Resume ID to scope the search to one resume

search_education_by_competency

Find education entries that demonstrate competency with a given skill — useful for matching a candidate's coursework/training to a specific position's requirements.

Returns: id, institution, degree, year, matched_competencies, resume_id.

ParameterTypeDescription
competencystringSkill/competency name fragment to search for (case-insensitive, partial match)
Ver o original no GitHub

Bom para

Relacionados