Herramienta MCP de IOL

Una herramienta de Protocolo de Contexto de Modelo (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 IOL
• Variables de entorno configuradas con sus 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 IOL:

IOL_USER=tu_nombre_de_usuario IOL_PASS=tu_contraseña

Configurar Claude Desktop

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

open ~/Library/Application\ Support/Claude

2. Cree o edite claude_desktop_config.json:

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

3. Añada la siguiente configuración:

{ "mcpServers": { "iol": {"command": "/Usuarios/Su_USUARIO/.local/bin/uv", "args": [ "--directory", "/Usuarios/su_nombre_usuario/proyectos/patio/mcpiol", "run", "main.py" ] } }

Notas importantes:

• Sustituye TU_NOMBRE_USUARIO por tu nombre de usuario real
• Tanto el comando como --directory deben ser rutas absolutas
• Puede encontrar la ruta de instalación de uv ejecutando which uv en el terminal

Ejecución de las pruebas

Para ejecutar el conjunto de pruebas

pytest pruebas/prueba_cliente.py -v

Para obtener un informe de cobertura:

pytest pruebas/prueba_cliente.py --cov=cliente -v

Solución de problemas

1. Si las herramientas no aparecen en Claude Desktop:

   • Compruebe que su archivo de configuración es correcto
   • Reinicie Claude Desktop
   • Compruebe la ruta y las dependencias de Python

2. Si falla la autenticación:

   • Verifique que su archivo .env existe y tiene las credenciales correctas
   • Compruebe el estado de la API IOL
   • Asegúrese de que su cuenta IOL está activa

Licencia

MIT

Contribución

No dudes en abrir incidencias o enviar pull requests.