servidor de acciones kospi-kosdaq

Un servidor MCP que proporciona datos bursátiles KOSPI/KOSDAQ mediante FastMCP.

Características

• Busque símbolos y nombres de cotizaciones de KOSPI/KOSDAQ

• Recuperar datos OHLCV para un stock específico

• Recuperar datos de capitalización de mercado para una acción específica

• Recupere datos fundamentales (PER/PBR/rendimiento de dividendos) para una acción específica

• Recupere el volumen de operaciones por tipo de inversor para una acción específica

Related MCP server: Stock Info Service

Herramientas disponibles

• load_all_tickers : carga todos los símbolos y nombres de tickers para KOSPI y KOSDAQ en la memoria.

  • Sin argumentos.

• get_stock_ohlcv : recupera datos OHLCV (Apertura/Máximo/Mínimo/Cierre/Volumen) para una acción específica.

  • fromdate (cadena, obligatoria): Fecha de inicio de la recuperación (AAAAMMDD)

  • todate (cadena, obligatoria): Fecha de finalización de la recuperación (AAAAMMDD)

  • ticker (cadena, obligatorio): símbolo bursátil

  • adjusted (booleano, opcional): si se utilizan precios ajustados (Verdadero: ajustado, Falso: sin ajustar). El valor predeterminado es Verdadero.

• get_stock_market_cap : recupera datos de capitalización de mercado para una acción específica.

  • fromdate (cadena, obligatoria): Fecha de inicio de la recuperación (AAAAMMDD)

  • todate (cadena, obligatoria): Fecha de finalización de la recuperación (AAAAMMDD)

  • ticker (cadena, obligatorio): símbolo bursátil

• get_stock_fundamental : recupera datos fundamentales (PER/PBR/rendimiento de dividendos) para una acción específica.

  • fromdate (cadena, obligatoria): Fecha de inicio de la recuperación (AAAAMMDD)

  • todate (cadena, obligatoria): Fecha de finalización de la recuperación (AAAAMMDD)

  • ticker (cadena, obligatorio): símbolo bursátil

• get_stock_trading_volume : recupera el volumen de operaciones por tipo de inversor para una acción específica.

  • fromdate (cadena, obligatoria): Fecha de inicio de la recuperación (AAAAMMDD)

  • todate (cadena, obligatoria): Fecha de finalización de la recuperación (AAAAMMDD)

  • ticker (cadena, obligatorio): símbolo bursátil

Instalación

Este paquete requiere uv para su instalación y ejecución.

Instalación mediante herrería

Para instalar automáticamente KOSPI/KOSDAQ Stock Data Server para Claude Desktop a través de Smithery :

npx -y @smithery/cli install @dragon1086/kospi-kosdaq-stock-server --client claude

Instalación manual

# Create and activate a virtual environment
uv venv .venv
source .venv/bin/activate  # On Unix/macOS
# .venv\Scripts\activate   # On Windows

# Install the package
uv pip install kospi-kosdaq-stock-server

Configuración para Claude.app

Después de instalar el paquete, debe configurar el servidor MCP en su archivo claude_desktop_config.json .

1. Localice el archivo de configuración:

   • En macOS, el archivo normalmente se encuentra en: /Users/username/Library/Application Support/Claude/claude_desktop_config.json

   • En Windows, el archivo normalmente se encuentra en: %APPDATA%/Claude/claude_desktop_config.json

2. Agregue la configuración del servidor: abra el archivo claude_desktop_config.json y agregue una nueva entrada al objeto mcpServers :

{
    "mcpServers": {
        "kospi-kosdaq": {
            "command": "uvx",
            "args": ["kospi_kosdaq_stock_server"]
        }
    }
}

Detalles de configuración:

• command : utilice uvx para aprovechar el aislamiento y la gestión de dependencias de uv

• args : Solo se necesita el nombre del paquete ya que el punto de entrada está definido en el paquete

• No se requieren variables de entorno adicionales

3. Reiniciar Claude: después de guardar los cambios en claude_desktop_config.json , reinicie Claude para que los cambios surtan efecto.

Ejemplo de uso

Después de configurar el servidor, puedes usarlo en Claude de esta manera:

1. Primero, cargue todos los tickers bursátiles disponibles:

Human: Please load all available stock tickers.
Assistant: I'll help you load all KOSPI and KOSDAQ stock tickers.

> Using tool 'load_all_tickers'...
Successfully loaded 2,873 stock tickers.

2. Obtenga datos OHLCV para una acción específica:

Human: Show me Samsung Electronics' stock data for the last month.
Assistant: I'll retrieve Samsung Electronics' (005930) OHLCV data for the last month.

> Using tool 'get_stock_ohlcv'...
Date        Open    High    Low     Close   Volume
2024-02-14  73,800  74,000  73,400  73,700  7,823,124
2024-02-13  73,600  74,200  73,200  73,800  8,943,217
...