🚀 kospi-kosdaq-stock-server 中文版

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

✨ 主要特性

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

📦 安装指南

此包的安装需要 uv。

通过 Smithery 安装

要通过 Smithery 安装，可使用以下命令：

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

安装依赖

安装必要的 Python 包：

pip install python-koapy

环境变量配置

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

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

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

💻 使用示例

基础用法

示例 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 环境变量，可能会导致程序运行出错。可以使用默认值或在代码中手动指定这些环境变量来避免此类错误。