Serveur Alpha Vantage MCP

Un serveur Model Context Protocol (MCP) qui fournit un accès aux API de données financières Alpha Vantage pour une utilisation avec Claude Desktop et d'autres applications compatibles MCP.

caractéristiques

• Données sur les actions: Cotations en temps réel et prix quotidiens historiques
• États financiers: Comptes de résultats, bilans et états des flux de trésorerie
• Informations sur les sociétés: Aperçus des entreprises et données sur les bénéfices
• Actualités et sentiments: Dernières nouvelles financières avec analyse des sentiments
• Gestion des erreurs: Gestion robuste des erreurs de l'API et gestion des limites de taux

📋 Conditions préalables

1. Clé API Alpha Vantage: Obtenez votre clé API gratuite auprès d'Alpha Vantage
2. Python 3.8+: Assurez-vous que Python est installé
3. Claude Desktop: Ou une autre application compatible avec MCP

🛠️ Installation

1. Cloner le dépôt

git clone https://github.com/yourusername/alphavantage-mcp-server.git cd alphavantage-mcp-server

2. Installer les dépendances

pip install -r requirements.txt

3. Obtenir votre clé API

1. Visiter Alpha Vantage
2. S'inscrire pour un compte gratuit
3. Copiez votre clé API

⚙️ Configuration

Pour Claude Desktop

Ajoutez cette configuration au fichier de configuration de votre Claude Desktop :

macOS: ~/Bibliothèque/Application Support/Claude/claude_desktop_config.jsonWindows: %APPDATA%\Claudeclaude_desktop_config.json

{ "mcpServers" : { "alphavantage" : {"command" : "python3", "args" : ["/path/to/alphavantage_server.py"], "env" : { "ALPHAVANTAGE_API_KEY" : "your_actual_api_key_here" } } } }

Important: Remplacez /path/to/alphavantage_server.py par le chemin réel de votre script et your_actual_api_key_here par votre clé API Alpha Vantage.

exemples d'utilisation

Une fois configuré, vous pouvez demander à Claude :

• "Obtenir le cours actuel de l'action Apple (AAPL)"
• "Montrez-moi le dernier compte de résultat de Microsoft"
• "Quelles sont les dernières nouvelles concernant l'action Tesla ?"
• "Obtenir les données du bilan d'Amazon"
• "Montrez-moi le tableau des flux de trésorerie de Google"

📊 Fonctions disponibles

🔧 Test

Testez votre installation en exécutant directement le serveur :

export ALPHAVANTAGE_API_KEY="your_api_key" python3 alphavantage_server.py

Le serveur devrait démarrer sans erreur. Appuyez sur Ctrl+C pour l'arrêter.

📝 Limites de l'API

• Niveau gratuit: 25 requêtes/jour pour les points d'extrémité premium, 500 requêtes/jour pour les points d'extrémité standard
• Limite de débit: 5 appels/minute
• Paliers Premium: Disponible pour des limites plus élevées

🐛 Dépannage

Problèmes courants

1. "Erreur "Serveur déconnecté

   • Vérifiez que votre clé API est correcte
   • Vérifiez le chemin d'accès au fichier dans votre configuration
   • Assurez-vous que les dépendances sont installées

2. "ModuleNotFoundError : No module named 'mcp'"

   • Installer les dépendances : pip install -r requirements.txt
   • Utilisez le chemin Python correct dans votre configuration

3. Erreurs de limite de débit de l'API

   • Vous avez dépassé les limites du niveau gratuit
   • Attendez que la limite de taux soit réinitialisée ou mettez votre plan à niveau

🤝 Contribuer

1. Créer un dépôt (Fork)
2. Créez une branche de fonctionnalités(git checkout -b feature/amazing-feature)
3. Validez vos modifications(git commit -m 'Add amazing feature')
4. Pousser vers la branche(git push origin feature/amazing-feature)
5. Ouvrir une Pull Request

licence

Ce projet est sous licence MIT - voir le fichier LICENSE pour plus de détails.

🙏 Remerciements

• Alpha Vantage pour avoir fourni l'API des données financières
• Anthropic pour avoir créé le Model Context Protocol (protocole de contexte de modèle)
• La communauté MCP pour les outils et la documentation

📞 Support

Si vous rencontrez des problèmes ou si vous avez des questions :

1. Consultez la section de dépannage
2. Recherchez les problèmes existants sur GitHub
3. Créez un nouveau problème avec des informations détaillées sur votre problème