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.