alphavantage stock mcp

datos de acciones, análisis de acciones

Documentación

Servidor MCP de Datos de Acciones Alpha Vantage para Cuenta Gratuita

Idiomas del README: Inglés | Chino

NPM Version License: MIT

Una implementación en TypeScript/Node.js del servidor del Protocolo de Contexto de Modelos (MCP) para acceder a datos históricos del mercado de valores a través de la API de Alpha Vantage. Este servidor permite que los LLM y los flujos de trabajo agénticos interactúen sin problemas con datos financieros.

⚠️ Solo Cuenta Gratuita Este servidor MCP está diseñado específicamente para cuentas de nivel gratuito de Alpha Vantage. Solo utiliza endpoints de API disponibles en el plan gratuito. Los endpoints de nivel de pago no son compatibles.

🚀 Características

  • Compatible con Nivel Gratuito: Funciona completamente dentro de los límites de la cuenta gratuita de Alpha Vantage
  • Datos Diarios de Acciones: Accede a series temporales diarias con tamaños de salida configurables
  • TypeScript: Soporte completo de TypeScript con definiciones de tipos
  • Protocolo MCP: Compatible con aplicaciones habilitadas para MCP como Claude Desktop, VS Code y más

📋 Requisitos Previos

  • Clave de API gratuita de Alpha Vantage

🔑 Obtención de una Clave de API

  1. Regístrate para obtener una Clave de API gratuita de Alpha Vantage
  2. Copia tu clave de API para la integración con clientes MCP

🔌 Integración con Clientes MCP

Configuración json de MCP

Añade esta configuración json:

{
  "mcpServers": {
    "alphavantage-stock-data": {  
      "command": "npx",
      "args": [
        "alphavantage-stock-mcp"
      ],
      "env": {
        "ALPHAVANTAGE_API_KEY": "YOUR-ALPHA-VANTAGE-API-KEY"
      }
    }
  }
}

🛠️ Herramientas Disponibles

get-stock-data

Obtén datos de acciones con un símbolo e intervalo especificados. Devuelve los últimos 100 puntos de datos.

Parámetros:

  • symbol (obligatorio): Símbolo de la acción (por ejemplo, "AAPL", "GOOGL", "MSFT")
  • interval (opcional): Intervalo de tiempo - "daily", "weekly", "monthly" (por defecto: "daily")

Ejemplo de Uso:

Get the latest weekly data for Apple stock
Symbol: AAPL
Interval: weekly

🤝 Contribuciones

¡Agradecemos las contribuciones! Por favor, sigue estos pasos:

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

🙏 Agradecimientos