IOL MCP Server

IOL MCP Server

Servidor MCP (Model-Controller-Proxy) para la API de InvertirOnline (IOL).

Descripción

Este proyecto implementa un servidor MCP que actúa como intermediario entre el cliente y la API de InvertirOnline. Proporciona una interfaz simplificada y estructurada para acceder a las funcionalidades de la API.

Características

• Autenticación automática con manejo de tokens
• Endpoints para consulta de portafolio
• Endpoints para consulta de títulos y cotizaciones
• Manejo de errores y reintentos
• Logging detallado
• Soporte para Docker y Docker Compose
• Hot-reload para desarrollo

Requisitos

• Python 3.11+
• FastMCP >= 2.10.6
• Docker y Docker Compose (opcional)
• Cuenta de InvertirOnline

Instalación

Usando Docker (Recomendado)

1. Clonar el repositorio:

2. Copiar el archivo de ejemplo de variables de entorno:

3. Editar el archivo .env con tus credenciales:

4. Iniciar los servicios con Docker Compose:

Instalación Manual

1. Clonar el repositorio:

2. Asegurarse de tener Python 3.11 o superior:

3. Instalar dependencias:

4. Configurar variables de entorno:

5. Iniciar el servidor:

Uso de Docker Compose

El proyecto incluye dos servicios en Docker Compose:

1. iol-mcp (Puerto 8000):
   • Servidor principal
   • Sin hot-reload
   • Para producción
2. iol-mcp-sse (Puerto 8001):
   • Servidor con hot-reload
   • Para desarrollo
   • Actualiza automáticamente al modificar el código

Comandos Útiles

Endpoints Disponibles

Portafolio

• obtener_portafolio: Obtiene el portafolio del usuario
  • Parámetros:
    • pais (opcional): Filtrar por país
• obtener_operaciones: Obtiene las operaciones del usuario
  • Parámetros:
    • filtro (opcional): Tipo de operación
    • pais (opcional): País de la operación
    • estado (opcional): Estado de la operación
    • fecha_desde (opcional): Fecha desde (YYYY-MM-DD)
    • fecha_hasta (opcional): Fecha hasta (YYYY-MM-DD)
    • numero (opcional): Número de operación

Títulos

• obtener_cotizacion: Obtiene la cotización de un título
  • Parámetros:
    • simbolo: Símbolo del título
    • mercado: Mercado del título
    • plazo (opcional): Plazo de la cotización
• obtener_panel: Obtiene el panel de un instrumento
  • Parámetros:
    • instrumento: Tipo de instrumento
    • panel: Tipo de panel
    • pais: País del panel
• obtener_opciones: Obtiene las opciones de un título
  • Parámetros:
    • simbolo: Símbolo del título
    • mercado: Mercado del título
• obtener_puntas: Obtiene las puntas de un título
  • Parámetros:
    • simbolo: Símbolo del título
    • mercado: Mercado del título
    • plazo (opcional): Plazo de la cotización

Contribuir

1. Fork el proyecto
2. Crear una rama para tu feature (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
4. Push a la rama (git push origin feature/AmazingFeature)
5. Abrir un Pull Request

Licencia

Este proyecto está licenciado bajo la Licencia MIT - ver el archivo LICENSE para más detalles.