Stock Market MCP Server

Stock Market MCP Server

Un servidor MCP basado en TypeScript para obtener datos del mercado de valores. Este servidor proporciona información del mercado de valores en tiempo real y datos financieros de empresas a través de la API de Alpha Vantage.

Información clave para generar este MCPServer

• .clinerules
• api-key

1.Plan mode

help me build a stock market mcp server that uses the AlphaVantage public API
I want it to have these tools：
- generate US market report/briefing
- generate financial statement for company
- get ticker price for company
- any other basic tools you think would be helpful
- api key: <you api key>


2. please test all the tools to confirm their functionality

Características

Herramientas

• get_ticker_price - Obtener el precio de las acciones en tiempo real

  • Requiere proporcionar el símbolo de la acción como parámetro
  • Devuelve el precio más reciente de la acción y la marca de tiempo

• get_market_report - Obtener el informe del mercado estadounidense

  • Proporciona una visión general del estado general del mercado

• get_financial_statement - Obtener estados financieros de la empresa

  • Admite tres tipos de informes: estado de resultados (income), balance general (balance) y estado de flujo de efectivo (cashflow)
  • Requiere proporcionar el símbolo de la acción y el tipo de informe

• get_company_overview - Obtener información general de la empresa

  • Requiere proporcionar el símbolo de la acción
  • Devuelve indicadores clave e información básica de la empresa

Configuración del entorno de desarrollo

Instalar dependencias

npm install

Compilar el proyecto

npm run build

Modo de desarrollo (recompilación automática)

npm run watch

Instrucciones de instalación

Para usar este servidor en Claude Desktop, debe agregar la configuración del servidor:

MacOS

Ruta del archivo de configuración: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Ruta del archivo de configuración: %APPDATA%/Claude/claude_desktop_config.json

Ejemplo de configuración:

{
  "mcpServers": {
    "stock-market-server": {
      "command": "/path/to/stock-market-server/build/index.js"
    }
  }
}

Depuración

Dado que el servidor MCP se comunica a través de entrada/salida estándar (stdio), la depuración puede resultar difícil. Se recomienda usar la herramienta MCP Inspector para depurar:

npm run inspector

Después de ejecutarlo, Inspector proporcionará una dirección de acceso al navegador, a través de la cual puede usar las herramientas de depuración en el navegador.

Stack tecnológico

• TypeScript
• Node.js
• Alpha Vantage API
• MCP SDK (@modelcontextprotocol/sdk)

Notas importantes

• Antes de usar, asegúrese de tener una clave API de Alpha Vantage válida
• Todas las respuestas de la API se devuelven en formato JSON
• Tenga en cuenta los límites de frecuencia de llamadas de la API de Alpha Vantage

Licencia

[Agregar información de licencia]