Servidor MCP Alpha Vantage Stock

Este es un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona datos bursátiles desde la API de Alpha Vantage. Permite a Claude y a otros clientes de MCP acceder a datos bursátiles históricos y en tiempo real.

Características

• Obtenga datos bursátiles intradiarios con intervalos personalizables

• Obtenga datos bursátiles diarios

• Generar alertas de stock basadas en movimientos de precios

• Acceda a los datos bursátiles como recursos

Related MCP server: AlphaVantage-MCP

Prerrequisitos

• Node.js 16 o superior

• Una clave API de Alpha Vantage (obtenga una gratis en Alpha Vantage )

Instalación

1. Clonar este repositorio

2. Instalar dependencias:

   npm install

3. Cree un archivo .env en el directorio raíz y agregue su clave API de Alpha Vantage:

   ALPHA_VANTAGE_API_KEY=your_api_key_here

Construyendo y funcionando

Construya el código TypeScript:

npm run build

Ejecutar el servidor:

npm start

Para desarrollo con recarga automática:

npm run dev

Pruebe el cliente API:

npm test

Uso con Claude para escritorio

Para utilizar este servidor MCP con Claude for Desktop:

1. Abrir Claude para escritorio

2. Vaya a Configuración > Desarrollador > Editar configuración

3. Agregue lo siguiente a su claude_desktop_config.json :

{
  "mcpServers": {
    "alpha-vantage": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "YOUR_API_KEY"
      } 
    }
  }
}

Reemplace /absolute/path/to/dist/index.js con la ruta absoluta al archivo index.js creado.

4. Reiniciar Claude para escritorio

Herramientas disponibles

obtener datos de stock

Obtiene datos bursátiles intradiarios para un símbolo específico.

Parámetros:

• symbol (obligatorio): Símbolo bursátil (p. ej., IBM, AAPL)

• interval (opcional): Intervalo de tiempo entre puntos de datos (1 min, 5 min, 15 min, 30 min, 60 min). Valor predeterminado: 5 min.

• outputsize (opcional): Cantidad de datos a devolver (compacto: últimos 100 puntos de datos, completo: hasta 20 años de datos). Predeterminado: compacto

obtener datos bursátiles diarios

Obtiene datos diarios de acciones para un símbolo específico.

Parámetros:

• symbol (obligatorio): Símbolo bursátil (p. ej., IBM, AAPL)

• outputsize (opcional): Cantidad de datos a devolver (compacto: últimos 100 puntos de datos, completo: hasta 20 años de datos). Predeterminado: compacto

obtener alertas de stock

Analiza datos bursátiles para generar alertas basadas en movimientos de precios.

Parámetros:

• symbol (obligatorio): Símbolo bursátil (p. ej., IBM, AAPL)

• threshold (opcional): Umbral porcentual para alertas de movimiento de precios. Valor predeterminado: 5

Recursos disponibles

datos bursátiles

Acceda a los datos de stock directamente como recurso.

Plantilla de URI: stock://{symbol}/{interval}

Parámetros:

• symbol : Símbolo bursátil (por ejemplo, IBM, AAPL)

• interval : Intervalo de tiempo (diario, 1 min, 5 min, 15 min, 30 min, 60 min). Predeterminado: diario

Ejemplo de uso en Claude:

• ¿Puedes analizar estos datos bursátiles: stock://AAPL/daily?

• ¿Qué opinas de estos datos: stock://MSFT/5min?

Licencia

ISC