remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Available as a PyPI package that can be installed via the Python package manager to enable the KOSPI/KOSDAQ stock data functionality.

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

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 .

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

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:

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.

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools