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)

Related MCP server: Stock Ticker MCP Server

Configuración

1. Instalar dependencias

   npm install

2. 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 .

3. 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:

1. Asegúrese de que su clave API de Alpha Vantage esté configurada correctamente en el archivo .env

2. Comprueba que estás utilizando la versión 18 o superior de Node.js

3. Verifique que la ruta en la configuración de su cliente MCP sea correcta

4. Reinicie su cliente MCP