Kospi Kosdaq Stock Server

🚀 kospi-kosdaq-stock-server 中文版

这是一个使用 FastMCP 提供 KOSPI/KOSDAQ 股票数据的 MCP 服务器，可助力用户查找股票代码与名称、获取股票的 OHLCV 数据、市值数据、基本面数据以及按投资者类型划分的交易量等。

✨ 主要特性

• 查找 KOSPI/KOSDAQ 的股票代码和名称。
• 获取特定股票的 OHLCV（开盘价/最高价/最低价/收盘价/成交量）数据。
• 获取特定股票的市值数据。
• 获取特定股票的基本面数据（PER/PBR/股息率）。
• 获取特定股票按投资者类型划分的交易量。

📦 安装指南

此包的安装需要 uv。

通过 Smithery 安装

要通过 Smithery 安装：

smithery install @dragon1086/kospi-kosdaq-stock-server

配置说明

环境变量

此包需要以下环境变量来配置：

• KOSPI_API_KEY：KOSPI 的 API 密钥。
• KOSDAQ_API_KEY：KOSDAQ 的 API 密钥。

如果未设置这些环境变量，可以使用默认值或在代码中手动指定。

安装依赖

安装必要的 Python 包：

pip install python-koapy

💻 使用示例

基础用法

示例 1：获取股票信息

获取所有股票列表

from kospi_kosdaq_stock_server import load_all_tickers

tickers = load_all_tickers()
print(tickers)

输出：

[{'stock_code': '005930', 'company_name': '三星电子'}, {'stock_code': '000660', 'company_name': 'SK 海力士'}, ...]

获取股票详细信息

from kospi_kosdaq_stock_server import get_stock_info

stock_info = get_stock_info('005930')
print(stock_info)

输出：

{
'基本信息': {
'公司名称': '三星电子',
'上市市场': 'KOSPI',
'行业分类': '半导体',
'成立日期': '1987-02-24',
'员工人数': 214836,
'官方网站': 'https://www.samsung.com/semiconductor'
},
'财务数据': {
'最新股价': 73800.0,
'市盈率': 15.89,
'市净率': 2.14,
'股息率': 0.56
}
}

获取历史价格数据

from kospi_kosdaq_stock_server import get_stock_price_data

prices = get_stock_price_data('005930', start_date='2024-01-01', end_date='2024-02-28')
print(prices)

输出：

示例 2：获取多个股票的历史价格数据

批量获取股票列表

from kospi_kosdaq_stock_server import get_multiple_stock_price_data

stock_codes = ['005930', '000660', '233780']
prices = get_multiple_stock_price_data(stock_codes, start_date='2024-01-01', end_date='2024-02-28')
print(prices)

输出：

{
'005930': DataFrame(...),
'000660': DataFrame(...),
'233780': DataFrame(...)
}

示例 3：使用环境变量

设置环境变量

在终端中设置以下环境变量：

export KOSPI_API_KEY=your_kospi_api_key
export KOSDAQ_API_KEY=your_kosdaq_api_key

然后运行 Python 脚本。

高级用法

可用工具

• load_all_tickers - 将所有 KOSPI 和 KOSDAQ 的股票代码和名称加载到内存中。

  • 无参数。

• get_stock_ohlcv - 获取特定股票的 OHLCV 数据。

  • fromdate（字符串，必填）：开始日期（YYYYMMDD）
  • todate（字符串，必填）：结束日期（YYYYMMDD）
  • ticker（字符串，必填）：股票代码
  • adjusted（布尔值，可选）：是否使用调整后的价格（True: 调整后，False: 未调整）。默认为 True。

• get_stock_market_cap - 获取特定股票的市值数据。

  • fromdate（字符串，必填）：开始日期（YYYYMMDD）
  • todate（字符串，必填）：结束日期（YYYYMMDD）
  • ticker（字符串，必填）：股票代码

• get_stock_fundamental - 获取特定股票的基本面数据。

  • fromdate（字符串，必填）：开始日期（YYYYMMDD）
  • todate（字符串，必填）：结束日期（YYYYMMDD）
  • ticker（字符串，必填）：股票代码

• get_stock_trading_volume - 获取特定股票按投资者类型划分的交易量。

  • fromdate（字符串，必填）：开始日期（YYYYMMDD）
  • todate（字符串，必填）：结束日期（YYYYMMDD）
  • ticker（字符串，必填）：股票代码

🔧 错误处理

未设置环境变量的错误

如果未设置 KOSPI_API_KEY 或 KOSDAQ_API_KEY 环境变量，可能会导致程序运行出错，请确保按照配置说明正确设置环境变量。