Alpha Vantage

Servidor MCP de Alpha Vantage

Un servidor del Protocolo de Contexto de Modelos (MCP) que proporciona acceso a las APIs de datos financieros de Alpha Vantage para su uso con Claude Desktop y otras aplicaciones compatibles con MCP.

🚀 Características

• Datos de acciones: Cotizaciones en tiempo real y precios diarios históricos
• Estados financieros: Estados de resultados, balances generales y estados de flujo de efectivo
• Información de la empresa: Resúmenes de empresas y datos de ganancias
• Noticias y sentimiento: Últimas noticias financieras con análisis de sentimiento
• Manejo de errores: Manejo robusto de errores de API y gestión de límites de velocidad

📋 Requisitos previos

1. Clave de API de Alpha Vantage: Obtén tu clave de API gratuita en Alpha Vantage
2. Python 3.8+: Asegúrate de tener Python instalado
3. Claude Desktop: U otra aplicación compatible con MCP

🛠️ Instalación

1. Clonar el repositorio

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

2. Instalar dependencias

pip install -r requirements.txt

3. Obtener tu clave de API

1. Visita Alpha Vantage
2. Regístrate para obtener una cuenta gratuita
3. Copia tu clave de API

⚙️ Configuración

Para Claude Desktop

Agrega esta configuración a tu archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %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"
      }
    }
  }
}

Importante: Reemplaza /path/to/alphavantage_server.py con la ruta real a tu script y your_actual_api_key_here con tu clave de API de Alpha Vantage.

🎯 Ejemplos de uso

Una vez configurado, puedes preguntarle a Claude:

• "Obtén la cotización actual de las acciones de Apple (AAPL)"
• "Muéstrame el último estado de resultados de Microsoft"
• "¿Cuáles son las últimas noticias sobre las acciones de Tesla?"
• "Obtén los datos del balance general de Amazon"
• "Muéstrame el estado de flujo de efectivo de Google"

📊 Funciones disponibles

Función	Descripción
get_stock_quote	Precio actual de las acciones y métricas básicas
get_daily_prices	Datos históricos de precios diarios
get_income_statement	Estados de resultados anuales
get_balance_sheet	Datos anuales del balance general
get_cash_flow	Estados anuales de flujo de efectivo
get_company_overview	Fundamentos de la empresa y métricas clave
get_news_sentiment	Últimas noticias con análisis de sentimiento
get_earnings	Datos de ganancias trimestrales y anuales

🔧 Pruebas

Prueba tu instalación ejecutando el servidor directamente:

export ALPHAVANTAGE_API_KEY="your_api_key"
python3 alphavantage_server.py

El servidor debería iniciarse sin errores. Presiona Ctrl+C para detenerlo.

📝 Límites de la API

• Nivel gratuito: 25 solicitudes/día para endpoints premium, 500 solicitudes/día para endpoints estándar
• Límite de velocidad: 5 llamadas/minuto
• Niveles premium: Disponibles para límites más altos

🐛 Solución de problemas

Problemas comunes

1. Error de "Servidor desconectado"

   • Verifica que tu clave de API sea correcta
   • Verifica la ruta del archivo en tu configuración
   • Asegúrate de que las dependencias estén instaladas

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

   • Instala las dependencias: pip install -r requirements.txt
   • Usa la ruta correcta de Python en tu configuración

3. Errores de límite de velocidad de la API

   • Has excedido los límites del nivel gratuito
   • Espera a que se restablezca el límite de velocidad o mejora tu plan

🤝 Contribuciones

1. Haz un fork del repositorio
2. Crea una rama de características (git checkout -b feature/amazing-feature)
3. Haz commit de tus cambios (git commit -m 'Add amazing feature')
4. Haz push a la rama (git push origin feature/amazing-feature)
5. Abre una Solicitud de Extracción (Pull Request)

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.

🙏 Agradecimientos

• Alpha Vantage por proporcionar la API de datos financieros
• Anthropic por crear el Protocolo de Contexto de Modelos
• La comunidad de MCP por las herramientas y la documentación

📞 Soporte

Si encuentras algún problema o tienes preguntas:

1. Consulta la sección de solución de problemas
2. Busca en los problemas existentes de GitHub
3. Crea un nuevo problema con información detallada sobre tu problema

---