Servidor MCP de currículum JSON

Logotipo de currículum JSON

Automatice las actualizaciones de su currículum con IA analizando sus proyectos de codificación

Instalación • Características • Uso • Configuración • Contribución • Pruebas

¿Qué es JSON Resume MCP Server?

Este es un servidor de Protocolo de Contexto de Modelo (MCP) que mejora los asistentes de IA con la capacidad de actualizar su currículum JSON mediante el análisis de sus proyectos de programación. El servidor MCP proporciona herramientas que permiten a los asistentes de IA como los de Windsurf o Cursor :

Comprueba si tienes un CV JSON existente
Analice su base de código para comprender sus habilidades técnicas y proyectos.
Mejora tu currículum con detalles sobre tu proyecto actual

Con esta herramienta, puedes simplemente pedirle a tu asistente de IA que "mejore mi currículum con mi proyecto actual" y automáticamente analizará tu código, extraerá habilidades relevantes y detalles del proyecto, y actualizará tu currículum en consecuencia.

Vídeo de demostración: https://x.com/ajaxdavis/status/1896953226282594381

Características

Mejora del currículum : analiza automáticamente su base de código y agrega detalles del proyecto a su currículum.
Integración con GitHub : recupera y actualiza su currículum almacenado en GitHub Gists
Impulsado por IA : utiliza OpenAI para generar descripciones profesionales de sus proyectos y habilidades
Validación de TypeScript/Zod : garantiza que su currículum cumpla con el estándar JSON Resume
Ecosistema de currículum JSON : compatible con el registro de currículum JSON

Instalación

Prerrequisitos

Cuenta de GitHub con un token de acceso personal (con alcance gist)
Clave API de OpenAI
Node.js 18+
Un IDE con soporte MCP (Windsurf o Cursor)

Instalación mediante herrería

Para instalar mcp para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @jsonresume/mcp --client claude

Instalar mediante NPM

npm install -g @jsonresume/mcp

Instalar en Windsurf o Cursor

Agregue lo siguiente a su configuración de Windsurf o Cursor:

Windsurf

Abra Configuración → Servidores MCP y agregue:

{
  "jsonresume": {
    "command": "npx",
    "args": ["-y", "@jsonresume/mcp"],
    "env": {
      "GITHUB_TOKEN": "your-github-token",
      "OPENAI_API_KEY": "your-openai-api-key",
      "GITHUB_USERNAME": "your-github-username"
    }
  }
}

Cursor

Agregue a su ~/.cursor/mcp_config.json :

{
  "mcpServers": {
    "jsonresume": {
      "command": "npx",
      "args": ["-y", "@jsonresume/mcp"],
      "env": {
        "GITHUB_TOKEN": "your-github-token",
        "OPENAI_API_KEY": "your-openai-api-key",
        "GITHUB_USERNAME": "your-github-username"
      }
    }
  }
}

Uso

Una vez instalado y configurado, puedes utilizar los siguientes comandos con tu asistente de IA:

Mejore su currículum con el proyecto actual

Pregúntele a su asistente de IA:

"Can you enhance my resume with details from my current project?"

El asistente se encargará de:

Encuentra tu currículum existente en GitHub (o crea uno nuevo si es necesario)
Analice la base de código de su proyecto actual
Genera descripciones profesionales de tu proyecto y habilidades
Actualiza tu currículum con la nueva información
Guarde los cambios en GitHub
Proporcione un enlace para ver su currículum actualizado

Verifique el estado de su currículum

Pregúntele a su asistente de IA:

"Can you check if I have a JSON Resume?"

El asistente verificará si tienes un currículum existente y mostrará sus detalles.

Analice su base de código

Pregúntele a su asistente de IA:

"What technologies am I using in this project?"

El asistente analizará su base de código y le brindará información sobre lenguajes, tecnologías y confirmaciones recientes.

Configuración

El servidor MCP requiere las siguientes variables de entorno:

Variable	Descripción
`GITHUB_TOKEN`	Tu token de acceso personal de GitHub con permisos de gist
`GITHUB_USERNAME`	Tu nombre de usuario de GitHub
`OPENAI_API_KEY`	Su clave API de OpenAI

Desarrollo

Para ejecutar el servidor en modo de desarrollo:

Clonar el repositorio:

git clone https://github.com/jsonresume/mcp.git
cd mcp

Instalar dependencias:

npm install

Ejecutar en modo de desarrollo:

npm run dev

Esto inicia el servidor MCP con la herramienta de inspección para la depuración.

Contribuyendo

¡Agradecemos sus contribuciones! Aquí le mostramos cómo contribuir:

Bifurcar el repositorio
Crear una rama de características: git checkout -b feature/amazing-feature
Confirme sus cambios: git commit -m 'Add some amazing feature'
Empujar a la rama: git push origin feature/amazing-feature
Abrir una solicitud de extracción

Asegúrese de que su código siga el estilo existente e incluya pruebas adecuadas.

Pruebas

El servidor MCP incluye varios scripts de prueba para ayudar a depurar y verificar la funcionalidad.

Ejecución de pruebas

Todos los scripts de prueba se encuentran en el directorio tests/ .

Antes de ejecutar pruebas, configure sus variables de entorno:

export GITHUB_TOKEN=your_github_token
export OPENAI_API_KEY=your_openai_api_key
export GITHUB_USERNAME=your_github_username

Consultar la clave API de OpenAI

Valida que su clave API de OpenAI funcione correctamente:

npx tsx tests/check-openai.ts

Mejora del currículum simulado

Prueba la funcionalidad de mejora del currículum utilizando datos simulados (sin llamadas API):

npx tsx tests/debug-mock.ts

Prueba completa de mejora del currículum

Prueba el proceso completo de mejora del currículum con llamadas API en vivo:

npx tsx tests/debug-enhance.ts

Prueba de protocolo MCP

Prueba la comunicación del protocolo del servidor MCP:

node tests/test-mcp.js

Añadiendo a package.json

Para mayor comodidad, puede agregar estos comandos de prueba a su package.json:

"scripts": {
  "test:openai": "tsx tests/check-openai.ts",
  "test:mock": "tsx tests/debug-mock.ts",
  "test:enhance": "tsx tests/debug-enhance.ts",
  "test:mcp": "node tests/test-mcp.js"
}

Luego ejecútelos con npm run test:mock , etc.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud

Currículum JSON para el estándar de currículum
Protocolo de contexto del modelo para permitir la integración de herramientas de IA
OpenAI para potenciar las mejoras del currículum con IA

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Un servidor que mejora los asistentes de IA con la capacidad de actualizar su currículum JSON analizando sus proyectos de codificación, extrayendo automáticamente habilidades y generando descripciones profesionales.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Calc Tools
nbiish
A
security
F
license
A
quality
A server that provides advanced mathematical and financial calculation capabilities for AI code assistants, enabling them to perform complex calculations like symbolic calculus, numerical methods, and financial analysis without implementing algorithms directly.
Last updated -
18
1
JavaScript
Unity MCP Integration
quazaai
-
security
A
license
-
quality
A server that enables AI assistants to understand and interact with Unity projects in real-time, providing access to scene hierarchy, project settings, and the ability to execute code directly in the Unity Editor.
Last updated -
40
MIT License
PapersWithCode MCP
hbg
-
security
A
license
-
quality
A server that allows AI assistants to search for research papers, read their content, and access related code repositories through the PapersWithCode API.
Last updated -
9
Python
MIT License
MCP Server
tcpipuk
-
security
A
license
-
quality
A server that enables AI assistants like Claude to safely run Python code and access websites, processing data for better AI understanding while providing helpful error messages.
Last updated -
2
Python
GPL 3.0

View all related MCP servers

JSON Resume MCP Server