mcp-server-llamadas

Llamadas MCP

Servidor MCP (Model Context Protocol) para gestión completa de llamadas de consultoría. Permite agendar, actualizar, cancelar y hacer seguimiento de llamadas con clientes.

Características

• Gestión completa de llamadas: Crear, leer, actualizar y eliminar llamadas
• Estados de llamada: Programada, completada, cancelada, reprogramada
• Filtros avanzados: Por estado, rango de fechas, cliente
• Soporte multi-base de datos: SQLite, PostgreSQL, MySQL
• Estadísticas: Métricas sobre llamadas realizadas

Instalación

El servidor se instala automáticamente al usarlo con npx.

Configuración con Claude Desktop

Agrega el servidor a tu configuración MCP:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

SQLite (por defecto)

{
  "mcpServers": {
    "llamadas": {
      "command": "npx",
      "args": [
        "mcp-server-llamadas"
      ]
    }
  }
}

PostgreSQL

{
  "mcpServers": {
    "llamadas": {
      "command": "npx",
      "args": [
        "mcp-server-llamadas",
        "postgresql://usuario:password@host:5432/nombre-db"
      ]
    }
  }
}

MySQL

{
  "mcpServers": {
    "llamadas": {
      "command": "npx",
      "args": [
        "mcp-server-llamadas",
        "mysql://usuario:password@host:3306/nombre-db"
      ]
    }
  }
}

SQLite personalizado

{
  "mcpServers": {
    "llamadas": {
      "command": "npx",
      "args": [
        "mcp-server-llamadas",
        "/ruta/personalizada/llamadas.db"
      ]
    }
  }
}

Base de datos

El servidor soporta múltiples bases de datos:

SQLite (por defecto)

• Ubicación por defecto: ~/.llamadas-mcp/llamadas.db
• Personalizada: Pasa la ruta como argumento
• La tabla se crea automáticamente

PostgreSQL

• Formato: postgresql://usuario:password@host:puerto/database
• La tabla se crea automáticamente

MySQL

• Formato: mysql://usuario:password@host:puerto/database
• La tabla se crea automáticamente

Publicar en npm

# Login en npm
npm login

# Publicar
npm publish --access public

Uso local (desarrollo)

npm install
npm run build
node build/index.js postgresql://user:pass@host:5432/db

Esquema de la tabla llamadas

• id: Identificador único (autoincremental)
• cliente_nombre: Nombre del cliente
• cliente_email: Email del cliente
• cliente_telefono: Teléfono (opcional)
• fecha_hora: Fecha y hora de la llamada (ISO 8601)
• duracion_minutos: Duración estimada
• tipo_consultoria: Tipo de consultoría
• estado: programada | completada | cancelada | reprogramada
• notas: Notas adicionales
• link_reunion: URL de la reunión virtual
• creado_en: Timestamp de creación
• actualizado_en: Timestamp de última actualización

Herramientas disponibles

1. crear_llamada

Crea una nueva llamada de consultoría.

Parámetros requeridos:

• cliente_nombre: Nombre completo del cliente
• cliente_email: Email del cliente
• fecha_hora: Fecha y hora en formato ISO 8601
• tipo_consultoria: Tipo de consultoría

Parámetros opcionales:

• cliente_telefono: Teléfono del cliente
• duracion_minutos: Duración en minutos (default: 30)
• notas: Notas adicionales
• link_reunion: URL de la reunión virtual

2. listar_llamadas

Lista todas las llamadas con filtros opcionales.

Filtros opcionales:

• estado: Filtrar por estado
• fecha_desde: Fecha inicial del rango
• fecha_hasta: Fecha final del rango
• cliente_email: Filtrar por email del cliente

3. obtener_llamada

Obtiene los detalles de una llamada específica.

Parámetros requeridos:

• id: ID de la llamada

4. actualizar_llamada

Actualiza los datos de una llamada existente.

Parámetros requeridos:

• id: ID de la llamada

Parámetros opcionales: Cualquier campo de la llamada

5. eliminar_llamada

Elimina permanentemente una llamada.

Parámetros requeridos:

• id: ID de la llamada

6. cambiar_estado_llamada

Cambia el estado de una llamada.

Parámetros requeridos:

• id: ID de la llamada
• estado: Nuevo estado (programada | completada | cancelada | reprogramada)

Parámetros opcionales:

• notas: Notas sobre el cambio de estado

7. obtener_estadisticas

Obtiene estadísticas generales sobre las llamadas.

Sin parámetros requeridos

Retorna:

• Total de llamadas
• Llamadas programadas
• Llamadas completadas
• Llamadas canceladas
• Llamadas reprogramadas

Desarrollo

npm run watch

Licencia

MIT