使用说明
Dealer MCP Server 🚗
Descripción
Servidor de Protocolo de Contexto de Modelo (MCP) para gestión integral de concesionarios de vehículos. Permite automatizar operaciones de venta, inventario, financiamiento y más mediante una API potente y fácil de usar.
🌟 Características
- Gestión de inventario: Seguimiento completo de vehículos, búsqueda y filtrado
- Calculadora de financiamiento: Cálculo de pagos mensuales y generación de escenarios
- Agenda de pruebas de manejo: Programación y seguimiento de pruebas de manejo
- Cotizaciones: Generación de cotizaciones para clientes con cálculo automático de totales
- Facturación: Sistema completo de generación y gestión de facturas
- API REST: Interfaz para integración con otras aplicaciones
- Soporte para n8n: Flujos de trabajo automatizados
📋 Requisitos previos
- Bun 1.0+: Motor de JavaScript rápido y moderno
- Git: Para clonar el repositorio (opcional)
🚀 Inicio rápido
Instalación
# Clonar el repositorio
git clone https://github.com/onick/Dealer-vehicles.git
cd Dealer-vehicles
# Instalar dependencias
bun install
Ejecución
# Iniciar servidor en modo CLI
./dealer-mcp.sh
# Iniciar servidor en modo API REST
./start-api.sh
# Ejecutar pruebas
bun test
# Construir proyecto
bun run build
🔧 Herramientas disponibles
- Inventario: Gestión del inventario de vehículos
- Financiamiento: Cálculo de opciones de financiamiento
- Pruebas de Manejo: Programación y seguimiento de pruebas de manejo
- Cotizaciones: Generación y gestión de cotizaciones para clientes
- Facturas: Sistema de facturación completo
📚 Documentación
Para obtener más información sobre cómo utilizar este servidor MCP, consulta los siguientes documentos:
- Guía de Conexión: Instrucciones paso a paso para conectarse al servidor
- N8N Integración: Cómo integrar el servidor con n8n
- Ejemplos de Flujos en n8n: Ejemplos detallados de flujos de trabajo con n8n
- Facturas y Cotizaciones: Documentación sobre el módulo de facturas y cotizaciones
📝 Ejemplos de uso
Usando la línea de comandos
# Buscar vehículos Toyota
./dealer-mcp.sh --tool inventory --method searchInventory --params '{"brand":"Toyota"}'
# Calcular financiamiento
./dealer-mcp.sh --tool financing --method calculateFinancing --params '{"price":25000,"downPayment":5000,"term":60,"interestRate":0.045}'
Usando la API REST
# Buscar vehículos
curl -X POST -H "Content-Type: application/json" \
-d '{"tool":"inventory","method":"searchInventory","params":{"brand":"Toyota"}}' \
http://localhost:3000/api/mcp
👨💻 Autor
Marcelino Francisco Martinez
📄 Licencia
MIT
