@qubaomingg/stock-mcp

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

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:

Ejecutar el servidor:

Para desarrollo con recarga automática:

Pruebe el cliente API:

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 :

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