# 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

1. **Generar claves criptográficas:**
   ```bash
   npm run setup-keys
   ```

2. **Iniciar servidor de desarrollo:**
   ```bash
   npm run dev
   ```

3. **Ejecutar tests (incluyendo validación de firmas):**
   ```bash
   npm test
   ```

### Para Producción (Cloudflare Workers)

1. **Configurar secrets en Cloudflare:**
   ```bash
   # 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_ID
   ```

2. **Desplegar:**
   ```bash
   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:

```json
{
  "data": {
    // Datos originales de la herramienta MCP
  },
  "hash": "sha256_hash_de_los_datos",
  "signature": "firma_digital_en_base64",
  "timestamp": "2025-01-15T10:00:00Z",
  "publicKey": "-----BEGIN PUBLIC KEY-----\n...",
  "serverId": "cv-brayan-cordova-server",
  "version": "1.0"
}
```

### Verificación de Firmas

Usa la herramienta `verify_response_signature` para verificar cualquier respuesta:

```javascript
// Ejemplo de verificación desde un cliente MCP
const response = await mcpClient.callTool('get_candidate_profile');
const verifyResult = await mcpClient.callTool('verify_response_signature', {
    signedResponse: response.content[0].text
});
```

## 🛠️ Herramientas MCP Disponibles

### Información Básica (8 herramientas)
- `get_candidate_profile` - Perfil personal y resumen profesional
- `get_work_experience` - Experiencia laboral detallada
- `get_education_background` - Formación académica
- `get_certifications` - Certificaciones profesionales
- `get_technical_skills` - Habilidades técnicas categorizadas
- `get_soft_skills` - Habilidades blandas y idiomas
- `get_languages_interests` - Idiomas e intereses personales
- `search_candidate_info` - Búsqueda por palabras clave

### Presencia Online (3 herramientas) 
- `get_portfolio_website` - Sitio web personal y portfolio
- `get_github_profile` - Información de perfil GitHub
- `get_social_networks` - Redes sociales y presencia online

### Análisis Avanzado (4 herramientas)
- `evaluate_tech_stack` - Evalúa compatibilidad con tecnologías
- `assess_leadership_experience` - Analiza experiencia de liderazgo  
- `calculate_experience_years` - Calcula años de experiencia por tecnología
- `match_job_requirements` - Matching contra requisitos de trabajo

### Debugging (2 herramientas)
- `verify_response_signature` - Verifica firmas digitales
- `get_server_public_key` - Obtiene clave pública del servidor

## 🌐 Conexiones y Uso

### Cloudflare AI Playground

1. Ve a https://playground.ai.cloudflare.com/
2. Ingresa la URL de tu servidor: `https://your-worker-name.your-account.workers.dev/sse`
3. **Nota**: Todas las respuestas estarán firmadas digitalmente. Los datos originales están en el campo `data` de cada respuesta.

### Claude Desktop

Conecta tu servidor MCP a Claude Desktop usando el [mcp-remote proxy](https://www.npmjs.com/package/mcp-remote):

1. Sigue la [Guía de Anthropic](https://modelcontextprotocol.io/quickstart/user)
2. En Claude Desktop: Settings > Developer > Edit Config
3. Usa esta configuración:

```json
{
  "mcpServers": {
    "cv-recruitment-assistant": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"  // Local
        // "https://your-worker-name.your-account.workers.dev/sse"  // Producción
      ]
    }
  }
}
```

4. 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 firmas
- `npm run test:crypto` - Solo tests criptográficos 
- `npm run test:mcp` - Solo tests de herramientas MCP

## 📁 Estructura del Proyecto

```
src/
├── index.ts              # Servidor MCP principal con 17 herramientas
├── crypto.ts             # Sistema de firma digital
└── candidate-data.json   # Datos del CV estructurados

scripts/
└── generate-keys.js      # Generador de claves para desarrollo

tests/
├── run-tests.js          # Suite completa de tests
├── crypto.test.js        # Tests específicos de criptografía
└── mcp-tools.test.js     # Tests de herramientas MCP
```

## 🔒 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](./CLAUDE.md) - Instrucciones específicas para Claude Code
- [TESTING.md](./TESTING.md) - Documentación detallada de testing
- [docs/](./docs/) - Documentación técnica del proyecto