IOL MCP Tool

IOL MCP Tool

Una herramienta del Protocolo de Contexto de Modelos (MCP) para interactuar con la API de Invertir Online (IOL) a través de Claude Desktop.

Requisitos previos

• Aplicación Claude Desktop para Mac
• Python 3.8+
• Cuenta de trading de IOL
• Configuración de variables de entorno con tus credenciales de IOL

Instalación

1. Clona este repositorio:

git clone https://github.com/fernandezpablo85/mcpiol.git
cd mcpiol

2. Instala uv si aún no lo has hecho:

curl -LsSf https://astral.sh/uv/install.sh | sh

3. Instala las dependencias:

uv sync

4. Crea un archivo .env en la raíz del proyecto con tus credenciales de IOL:

IOL_USER=your_username
IOL_PASS=your_password

Configurar Claude Desktop

1. Abre el directorio de configuración de Claude Desktop:

open ~/Library/Application\ Support/Claude

2. Crea o edita claude_desktop_config.json:

touch ~/Library/Application\ Support/Claude/claude_desktop_config.json

3. Agrega la siguiente configuración:

{
  "mcpServers": {
    "iol": {
      "command": "/Users/YOUR_USERNAME/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/YOUR_USERNAME/projects/playground/mcpiol",
        "run",
        "main.py"
      ]
    }
  }
}

Notas importantes:

• Reemplaza YOUR_USERNAME con tu nombre de usuario real
• Tanto la ruta de command como la de --directory deben ser rutas absolutas
• Puedes encontrar la ruta de instalación de uv ejecutando which uv en la terminal

Ejecutar pruebas

Para ejecutar el conjunto de pruebas:

pytest tests/test_client.py -v

Para el informe de cobertura:

pytest tests/test_client.py --cov=client -v

Solución de problemas

1. Si las herramientas no aparecen en Claude Desktop:

   • Verifica que tu archivo de configuración sea correcto
   • Reinicia Claude Desktop
   • Revisa la ruta de Python y las dependencias

2. Si la autenticación falla:

   • Verifica que tu archivo .env exista y tenga las credenciales correctas
   • Revisa el estado de la API de IOL
   • Asegúrate de que tu cuenta de IOL esté activa

Licencia

MIT

Contribuciones

Siéntete libre de abrir problemas o enviar solicitudes de extracción.