Mercado de valores de MCP

Una herramienta de Protocolo de Contexto de Modelo (MCP) para recuperar datos bursátiles mediante la API Alpha Vantage. Esta herramienta proporciona acceso a datos bursátiles diarios de cualquier símbolo bursátil mediante una sencilla interfaz MCP.

Requisitos

Node.js v18 o superior
Una clave API de Alpha Vantage (nivel gratuito disponible)

Configuración

Instalar dependencias
npm install
Cree un archivo .env basado en .env.example y agregue su clave API de Alpha Vantage
ALPHA_VANTAGE_API_KEY=your_api_key_here
Puede obtener una clave API gratuita de Alpha Vantage .
Construir el proyecto
npm run build

Configuración del cliente MCP

Para usar esta herramienta con su cliente MCP, debe actualizar la configuración de su servidor MCP. Agregue lo siguiente a la configuración de su cliente:

{
  "mcpServers": {
    "stock-market": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-stock-market/build/index.js"
      ]
    }
  }
}

Asegúrese de reemplazar /ABSOLUTE/PATH/TO/PARENT/FOLDER con la ruta absoluta real al directorio principal que contiene este repositorio.

Herramientas disponibles

obtener datos de stock

Recupera datos diarios del mercado de valores para un símbolo de acciones específico.

Parámetros:

symbol : Símbolo bursátil (por ejemplo, IBM, AAPL, MSFT, GOOG, AMZN)

Ejemplo de uso en un cliente MCP:

@stock-market get-stock-data symbol=AAPL

Ejemplo de respuesta:

Stock: AAPL
Last Updated: 2025-03-12
Time Zone: US/Eastern

Daily Prices:

Date: 2025-03-12
Open: $178.35
High: $180.13
Low: $177.53
Close: $179.63
Volume: 58,492,206
---

Date: 2025-03-11
Open: $177.99
High: $179.70
Low: $176.86
Close: $178.95
Volume: 62,630,570
---

Desarrollo

Estructura del proyecto

src/index.ts - Archivo de la aplicación principal con la implementación del servidor MCP y las herramientas
build/ - Salida de JavaScript compilada
.env - Variables de entorno (clave API)

Comandos

npm run build - Construye el código TypeScript

Notas de uso de la API

Esta herramienta utiliza la API de Alpha Vantage para recuperar datos del mercado bursátil. La versión gratuita de Alpha Vantage tiene las siguientes limitaciones:

25 llamadas API por día
5 llamadas API por minuto

Si necesita más capacidad, considere actualizar a sus planes premium.

Solución de problemas

Si encuentra problemas:

Asegúrese de que su clave API de Alpha Vantage esté configurada correctamente en el archivo .env
Comprueba que estás utilizando la versión 18 o superior de Node.js
Verifique que la ruta en la configuración de su cliente MCP sea correcta
Reinicie su cliente MCP

MCP Stock Market

Integrations