Outil MCP IOL

Un outil MCP (Model Context Protocol) pour interagir avec l'API d'Invertir Online (IOL) à travers Claude Desktop.

Pré-requis

• Application Claude Desktop pour Mac
• Python 3.8+
• Compte de trading IOL
• Variables d'environnement configurées avec vos identifiants IOL

Installation de l'application

1. Clonez ce dépôt :

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

2. Installez uv si vous ne l'avez pas déjà fait :

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

3. Installer les dépendances :

uv sync

4. Créez un fichier .env à la racine du projet avec vos identifiants IOL :

IOL_USER=votre_nomd'utilisateur IOL_PASS=votre_mot_de_passe

Configurer Claude Desktop

1. Ouvrez le répertoire de configuration de Claude Desktop :

open ~/Bibliothèque/Application\ Support/Claude

2. Créez ou éditez le fichier claude_desktop_config.json:

touch ~/Bibliothèque/Application Support/Claude/claude_desktop_config.json

3. Ajoutez la configuration suivante :

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

Remarques importantes :

• Remplacez YOUR_USERNAME par votre nom d'utilisateur réel
• Les chemins d'accès à la commande et au répertoire doivent être des chemins absolus
• Vous pouvez trouver le chemin d'installation de votre uv en lançant which uv dans le terminal

Exécution des tests

Pour exécuter la suite de tests :

pytest tests/test_client.py -v

Pour obtenir un rapport de couverture :

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

Résolution des problèmes

1. Si les outils n'apparaissent pas dans Claude Desktop :

   • Vérifiez que votre fichier de configuration est correct
   • Redémarrer Claude Desktop
   • Vérifier le chemin d'accès et les dépendances de Python

2. Si l'authentification échoue :

   • Vérifiez que votre fichier .env existe et qu'il contient les informations d'identification correctes
   • Vérifier l'état de l'API IOL
   • Vérifiez que votre compte IOL est actif

Licence

MIT

Contribuer

N'hésitez pas à ouvrir des problèmes ou à soumettre des demandes de téléchargement.