Servidor MCP de Alpha Vantage

Un servidor Model Context Protocol (MCP) que proporciona acceso a las API de datos financieros de Alpha Vantage para su uso con Claude Desktop y otras aplicaciones compatibles con MCP.

características

• Datos bursátiles: Cotizaciones en tiempo real y precios históricos diarios
• Estados Financieros: Cuentas de resultados, balances y estados de flujo de caja
• Información sobre empresas: Visión general de la empresa y datos sobre beneficios
• Noticias y sentimiento: Últimas noticias financieras con análisis de sentimiento
• Gestión de errores: Sólida gestión de errores de API y gestión de límites de tarifa

requisitos previos

1. Clave API deAlpha Vantage: Obtenga su clave API gratuita de Alpha Vantage
2. Python 3.8+: Asegúrese 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 requisitos.txt

3. Obtenga su clave API

1. Visite Alpha Vantage
2. Regístrese para obtener una cuenta gratuita
3. Copie su clave API

⚙️ Configuración

Para Claude Desktop

Añada esta configuración a su archivo de configuración de Claude Desktop:

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

{"mcpServers": {"alphavantage": { "command": "python3", "args": ["/ruta/a/servidor_alphavantage.py"], "env": { "ALPHAVANTAGE_API_KEY": "your_actual_api_key_here" } } }

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

🎯 Ejemplos de uso

Una vez configurado, puedes preguntarle a Claude:

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

funciones disponibles

pruebas

Prueba tu instalación ejecutando el servidor directamente:

export ALPHAVANTAGE_API_KEY="tu_clave_api" python3 alphavantage_server.py

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

límites de la API

• Nivel gratuito: 25 solicitudes/día para los puntos finales premium, 500 solicitudes/día para los puntos finales estándar
• Límite de velocidad: 5 llamadas/minuto
• Niveles Premium: Disponible para límites superiores

solución de problemas

Problemas comunes

1. "Error "Servidor desconectado

   • Compruebe que su clave API es correcta
   • Verifique la ruta del archivo en su config
   • Asegúrese de que las dependencias están instaladas

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

   • Instale las dependencias: pip install -r requirements.txt
   • Utilice la ruta Python correcta en su configuración

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

   • Ha superado los límites de la capa gratuita
   • Espera a que se restablezca el límite de tarifa o actualiza tu plan

🤝 Contribuir

1. Fork el repositorio
2. Crea una rama(git checkout -b feature/amazing-feature)
3. Confirma tus cambios(git commit -m 'Añadir característica asombrosa')
4. Empuja a la rama(git push origin feature/amazing-feature)
5. Abre una Pull Request

📄 Licencia

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

🙏 Agradecimientos

• Alpha Vantage por proporcionar la API de datos financieros
• Anthropic por la creación del protocolo de contexto de modelo
• La comunidad MCP por las herramientas y la documentación

📞 Soporte

Si te encuentras con algún problema o tienes preguntas:

1. Consulta la sección de resolución de problemas
2. Busca problemas existentes en GitHub
3. Crea una nueva incidencia con información detallada sobre tu problema