kospi-kosdaq-stock-server

kospi-kosdaq-stock-server

site icon
2025.03.14 22
Python股票数据金融分析金融服务
kospi-kosdaq-stock-server 是一个基于 FastMCP 的 MCP 服务,专门用于提供韩国 KOSPI 和 KOSDAQ 股市的股票数据。该服务能够查询股票代码和名称,获取特定股票的开盘价、最高价、最低价、收盘价和成交量(OHLCV)数据,市场资本化数据,基本面数据(如市盈率、市净率和股息收益率),以及按投资者类型分类的交易量数据。
View on GitHub

Overview

基本能力

产品定位

kospi-kosdaq-stock-server 是一个专门用于提供韩国 KOSPI 和 KOSDAQ 股市数据的 MCP 服务。

核心功能

  • 查询 KOSPI/KOSDAQ 股票代码和名称
  • 获取特定股票的 OHLCV(开盘价、最高价、最低价、收盘价和成交量)数据
  • 获取特定股票的市场资本化数据
  • 获取特定股票的基本面数据(PER/PBR/股息收益率)
  • 获取特定股票按投资者类型分类的交易量数据

适用场景

  • 金融数据分析
  • 股票市场研究
  • 投资决策支持

工具列表

  • load_all_tickers - 加载所有 KOSPI 和 KOSDAQ 的股票代码和名称到内存中。
  • get_stock_ohlcv - 获取特定股票的 OHLCV 数据。
  • get_stock_market_cap - 获取特定股票的市场资本化数据。
  • get_stock_fundamental - 获取特定股票的基本面数据。
  • get_stock_trading_volume - 获取特定股票按投资者类型分类的交易量数据。

常见问题解答

使用教程

使用依赖

该服务需要 uv 进行安装和执行。

安装教程

通过 Smithery 安装

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

手动安装

# 创建并激活虚拟环境
uv venv .venv
source .venv/bin/activate  # 在 Unix/macOS 上
# .venv\Scripts\activate   # 在 Windows 上

# 安装包
uv pip install kospi-kosdaq-stock-server

调试方式

  1. 首先加载所有可用的股票代码:
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.
  1. 获取特定股票的 OHLCV 数据:
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
...

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。