Designed to be deployed and run on Cloudflare Workers platform, with support for secure secrets management and production deployment.
Provides tools to retrieve GitHub profile information for the candidate, including their GitHub presence and portfolio projects.
CV Recruitment Assistant - Servidor MCP con Firma Digital
Este es un servidor MCP (Model Context Protocol) avanzado que funciona como asistente de reclutamiento para el CV de Brayan Smith Cordova Tasayco. Todas las respuestas están firmadas digitalmente para garantizar autenticidad e integridad.
🚀 Características Principales
15 herramientas MCP especializadas para análisis de CV
Firma digital de todas las respuestas (RSA + SHA-256)
Verificación de integridad y autenticidad
Desarrollo local y producción con manejo seguro de claves
Tests automatizados para validar firmas digitales
🔧 Configuración Inicial
Para Desarrollo Local
Generar claves criptográficas:
npm run setup-keysIniciar servidor de desarrollo:
npm run devEjecutar tests (incluyendo validación de firmas):
npm test
Para Producción (Cloudflare Workers)
Configurar secrets en Cloudflare:
# Primero genera las claves localmente con npm run setup-keys # Luego copia las claves de .env.local y ejecuta: wrangler secret put MCP_PRIVATE_KEY wrangler secret put MCP_PUBLIC_KEY wrangler secret put MCP_SERVER_IDDesplegar:
npm run deploy
Tu servidor estará disponible en: https://your-worker-name.your-account.workers.dev
🔐 Formato de Respuestas Firmadas
Todas las herramientas MCP devuelven respuestas en el siguiente formato firmado digitalmente:
Verificación de Firmas
Usa la herramienta verify_response_signature para verificar cualquier respuesta:
🛠️ Herramientas MCP Disponibles
Información Básica (8 herramientas)
get_candidate_profile- Perfil personal y resumen profesionalget_work_experience- Experiencia laboral detalladaget_education_background- Formación académicaget_certifications- Certificaciones profesionalesget_technical_skills- Habilidades técnicas categorizadasget_soft_skills- Habilidades blandas y idiomasget_languages_interests- Idiomas e intereses personalessearch_candidate_info- Búsqueda por palabras clave
Presencia Online (3 herramientas)
get_portfolio_website- Sitio web personal y portfolioget_github_profile- Información de perfil GitHubget_social_networks- Redes sociales y presencia online
Análisis Avanzado (4 herramientas)
evaluate_tech_stack- Evalúa compatibilidad con tecnologíasassess_leadership_experience- Analiza experiencia de liderazgocalculate_experience_years- Calcula años de experiencia por tecnologíamatch_job_requirements- Matching contra requisitos de trabajo
Debugging (2 herramientas)
verify_response_signature- Verifica firmas digitalesget_server_public_key- Obtiene clave pública del servidor
🌐 Conexiones y Uso
Cloudflare AI Playground
Ve a https://playground.ai.cloudflare.com/
Ingresa la URL de tu servidor:
https://your-worker-name.your-account.workers.dev/sseNota: Todas las respuestas estarán firmadas digitalmente. Los datos originales están en el campo
datade cada respuesta.
Claude Desktop
Conecta tu servidor MCP a Claude Desktop usando el mcp-remote proxy:
Sigue la Guía de Anthropic
En Claude Desktop: Settings > Developer > Edit Config
Usa esta configuración:
Reinicia Claude Desktop
Importante: Claude recibirá todas las respuestas firmadas digitalmente. Para acceder a los datos, usa response.data en lugar de response directamente.
🧪 Testing y Validación
npm test- Ejecuta todos los tests incluyendo validación de firmasnpm run test:crypto- Solo tests criptográficosnpm run test:mcp- Solo tests de herramientas MCP
📁 Estructura del Proyecto
🔒 Seguridad y Cumplimiento
Este servidor implementa las mejores prácticas de seguridad:
Firma digital RSA-2048 de todas las respuestas
Verificación SHA-256 de integridad de datos
Claves privadas seguras en Cloudflare Workers secrets
Trazabilidad completa con timestamps y server IDs
Preparado para regulaciones (GDPR, AI Act)
📄 Documentación Adicional
CLAUDE.md - Instrucciones específicas para Claude Code
TESTING.md - Documentación detallada de testing
docs/ - Documentación técnica del proyecto