IOL MCP Tool

Una eina Model Context Protocol (MCP) per interactuar amb l'API d'Invertir Online (IOL) a través de Claude Desktop.

Requisits

• Aplicació Claude Desktop per a Mac
• Python 3.8+
• Compte de negociació IOL
• Configuració de variables d'entorn amb les teves credencials IOL

Instal·lació

1. Clona aquest repositori:

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

2. Instal·la uv si encara no el tens:

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

3. Instal·la les dependències:

uv sync

4. Crea un fitxer .env a la arrel del projecte amb les teves credencials IOL:

IOL_USER=your_username
IOL_PASS=your_password

Configurar Claude Desktop

1. Obre el directori de configuració 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. Afegeix la següent configuració:

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

Notes importants:

• Substitueix YOUR_USERNAME pel teu nom d'usuari real
• Tots els camins del command i de --directory han de ser camins absoluts
• Pots trobar el camí d'instal·lació de uv executant which uv al terminal

Executar proves

Per executar el conjunt de proves:

pytest tests/test_client.py -v

Per al informe de cobertura:

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

Resolució de problemes

1. Si les eines no apareixen a Claude Desktop:

   • Verifica que el teu fitxer de configuració sigui correcte
   • Reinicia Claude Desktop
   • Comprova el camí de Python i les dependències

2. Si l'autenticació falla:

   • Verifica que el fitxer .env existeixi i tingui les credencials correctes
   • Comprova l'estat de l'API IOL
   • Assegura't que el teu compte IOL estigui actiu

Llicència

MIT

Contribució

No dubtis a obrir issues o enviar pull requests.