金大哥 - kospi-kosdaq-stock-server MCP 详情

article

README

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

输出：

| 日期 | 开盘价 | 最高价 | 最低价 | 收盘价 | 成交量 | |-----------|--------|--------|--------|--------|--------| | 2024-01-01| 73600.0| 74200.0| 73200.0| 73800.0| 7823124| | 2024-01-02| 73800.0| 74000.0| 73500.0| 73700.0| 8943217| | ... | ... | ... | ... | ... | ... |

示例 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 环境变量，可能会导致程序运行出错，请确保按照配置说明正确设置环境变量。

kospi-kosdaq-stock-server