Alpha Vantage MCP Server

Un servidor Model Context Protocol (MCP) que proporciona accés a les API de dades financeres d'Alpha Vantage per a l'ús amb Claude Desktop i altres aplicacions compatibles amb MCP.

🚀 Funcionalitats

• Stock Data: Cotitzacions en temps real i preus diaris històrics
• Financial Statements: Comptes de resultats, balanços i fluxos de caixa
• Company Information: Resum de l'empresa i dades de guanys
• News & Sentiment: Notícies financeres actuals amb anàlisi de sentiment
• Error Handling: Gestió robusta d'errors d'API i de límit de velocitat

📋 Requisits

1. Alpha Vantage API Key: Obtén la teva clau API gratuïta a Alpha Vantage
2. Python 3.8+: Assegura't que tens Python instal·lat
3. Claude Desktop: O una altra aplicació compatible amb MCP

🛠️ Instal·lació

1. Clonar el repositori

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

2. Instal·lar dependències

pip install -r requirements.txt

3. Obtenir la teva clau API

1. Visita Alpha Vantage
2. Registra't per a un compte gratuït
3. Copia la teva clau API

⚙️ Configuració

Per a Claude Desktop

Afegeix aquesta configuració al fitxer de configuració de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows: %APPDATA%\Claude\claude_desktop_config.json

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

Important: Substitueix /path/to/alphavantage_server.py pel camí real al teu script i your_actual_api_key_here amb la teva clau API d'Alpha Vantage.

🎯 Exemples d'ús

Un cop configurat, pots preguntar a Claude:

• "Get the current stock quote for Apple (AAPL)"
• "Show me Microsoft's latest income statement"
• "What's the latest news about Tesla stock?"
• "Get Amazon's balance sheet data"
• "Show me Google's cash flow statement"

📊 Funcions disponibles

🔧 Proves

Prova la teva instal·lació executant el servidor directament:

export ALPHAVANTAGE_API_KEY="your_api_key"
python3 alphavantage_server.py

El servidor hauria d'iniciar sense errors. Prem Ctrl+C per aturar-lo.

📝 Limites d'API

• Free Tier: 25 requests/day per a endpoints premium, 500 requests/day per a endpoints estàndard
• Rate Limit: 5 calls/minute
• Premium Tiers: Disponibles per a límits més alts

🐛 Resolució de problemes

Problemes comuns

1. "Server disconnected" error

   • Comprova que la teva clau API és correcta
   • Verifica el camí del fitxer a la teva configuració
   • Assegura't que les dependències estan instal·lades

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

   • Instal·la les dependències: pip install -r requirements.txt
   • Utilitza el camí correcte de Python a la teva configuració

3. Errors de límit d'API

   • Has superat els límits del tier gratuït
   • Espereu que el límit es restableixi o milloreu el vostre pla

🤝 Contribució

1. Fork el repositori
2. Crea una branca de funcionalitat (git checkout -b feature/amazing-feature)
3. Fes commit dels canvis (git commit -m 'Add amazing feature')
4. Empuja a la branca (git push origin feature/amazing-feature)
5. Obre una Pull Request

📄 Llicència

Aquest projecte està llicenciat sota la MIT License - vegeu el fitxer LICENSE per a més detalls.

🙏 Agraïments

• Alpha Vantage per proporcionar l'API de dades financeres
• Anthropic per crear el Model Context Protocol
• La comunitat MCP per a eines i documentació

📞 Suport

Si trobes algun problema o tens preguntes:

1. Revisa la secció de resolució de problemes
2. Cerca problemes existents a GitHub issues
3. Crea un nou problema amb informació detallada sobre el teu problema