MCP 服务器

kospi-kosdaq

一个使用 FastMCP 提供 KOSPI/KOSDAQ 股票数据的 MCP 服务器。

金融

Tools

load_all_tickers

Loads all ticker symbols and names for KOSPI and KOSDAQ into memory. Returns: Dict[str, str]: A dictionary mapping tickers to stock names. Example: {"005930": "삼성전자", "035720": "카카오", ...}

get_stock_ohlcv

Retrieves OHLCV (Open/High/Low/Close/Volume) data for a specific stock. Args: fromdate (str): Start date for retrieval (YYYYMMDD) todate (str): End date for retrieval (YYYYMMDD) ticker (str): Stock ticker symbol adjusted (bool, optional): Whether to use adjusted prices (True: adjusted, False: unadjusted). Defaults to True. Returns: DataFrame: >> get_stock_ohlcv("20210118", "20210126", "005930") Open High Low Close Volume Date 2021-01-26 89500 94800 89500 93800 46415214 2021-01-25 87300 89400 86800 88700 25577517 2021-01-22 89000 89700 86800 86800 30861661 2021-01-21 87500 88600 86500 88100 25318011 2021-01-20 89000 89000 86500 87200 25211127 2021-01-19 84500 88000 83600 87000 39895044 2021-01-18 86600 87300 84100 85000 43227951

get_stock_market_cap

Retrieves market capitalization data for a specific stock. Args: fromdate (str): Start date for retrieval (YYYYMMDD) todate (str): End date for retrieval (YYYYMMDD) ticker (str): Stock ticker symbol Returns: DataFrame: >> get_stock_market_cap("20150720", "20150724", "005930") Market Cap Volume Trading Value Listed Shares Date 2015-07-24 181030885173000 196584 241383636000 147299337 2015-07-23 181767381858000 208965 259446564000 147299337 2015-07-22 184566069261000 268323 333813094000 147299337 2015-07-21 186039062631000 194055 244129106000 147299337 2015-07-20 187806654675000 128928 165366199000 147299337

get_stock_fundamental

Retrieves fundamental data (PER/PBR/Dividend Yield) for a specific stock. Args: fromdate (str): Start date for retrieval (YYYYMMDD) todate (str): End date for retrieval (YYYYMMDD) ticker (str): Stock ticker symbol Returns: DataFrame: >> get_stock_fundamental("20210104", "20210108", "005930") BPS PER PBR EPS DIV DPS Date 2021-01-08 37528 28.046875 2.369141 3166 1.589844 1416 2021-01-07 37528 26.187500 2.210938 3166 1.709961 1416 2021-01-06 37528 25.953125 2.189453 3166 1.719727 1416 2021-01-05 37528 26.500000 2.240234 3166 1.690430 1416 2021-01-04 37528 26.218750 2.210938 3166 1.709961 1416

get_stock_trading_volume

Retrieves trading volume by investor type for a specific stock. Args: fromdate (str): Start date for retrieval (YYYYMMDD) todate (str): End date for retrieval (YYYYMMDD) ticker (str): Stock ticker symbol Returns: DataFrame with columns: - Volume (Sell/Buy/Net Buy) - Trading Value (Sell/Buy/Net Buy) Broken down by investor types (Financial Investment, Insurance, Trust, etc.)

README

KOSPI/KOSDAQ 股票服务器

一个使用 FastMCP 提供 KOSPI/KOSDAQ 股票数据的 MCP 服务器。

功能

查找 KOSPI/KOSDAQ 股票代码和名称
检索特定股票的 OHLCV 数据
检索特定股票的市值数据
检索特定股票的基本面数据（PER/PBR/股息率）
检索特定股票按投资者类型划分的交易量

可用工具

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 - 检索特定股票的基本面数据（PER/PBR/股息率）。
- fromdate (字符串, 必需): 检索的开始日期 (YYYYMMDD)
- todate (字符串, 必需): 检索的结束日期 (YYYYMMDD)
- ticker (字符串, 必需): 股票代码
get_stock_trading_volume - 检索特定股票按投资者类型划分的交易量。
- fromdate (字符串, 必需): 检索的开始日期 (YYYYMMDD)
- todate (字符串, 必需): 检索的结束日期 (YYYYMMDD)
- ticker (字符串, 必需): 股票代码

安装

此软件包需要 uv 进行安装和执行。

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 KOSPI/KOSDAQ 股票数据服务器：

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

Claude.app 的配置

安装软件包后，您需要在 claude_desktop_config.json 文件中配置 MCP 服务器。

找到配置文件：
- 在 macOS 上，该文件通常位于： /Users/username/Library/Application Support/Claude/claude_desktop_config.json
- 在 Windows 上，该文件通常位于： %APPDATA%/Claude/claude_desktop_config.json
添加服务器配置： 打开 claude_desktop_config.json 文件，并将一个新条目添加到 mcpServers 对象：

{
    "mcpServers": {
        "kospi-kosdaq": {
            "command": "uvx",
            "args": ["kospi_kosdaq_stock_server"]
        }
    }
}

配置详情：

command: 使用 uvx 以利用 uv 的隔离和依赖管理
args: 只需要包名，因为入口点已在包中定义
不需要额外的环境变量

重启 Claude： 保存对 claude_desktop_config.json 的更改后，重启 Claude 以使更改生效。

使用示例

配置服务器后，您可以像这样在 Claude 中使用它：

首先，加载所有可用的股票代码：

Human: 请加载所有可用的股票代码。
Assistant: 我将帮助您加载所有 KOSPI 和 KOSDAQ 股票代码。

> Using tool 'load_all_tickers'...
Successfully loaded 2,873 stock tickers.

获取特定股票的 OHLCV 数据：

Human: 显示我三星电子过去一个月的股票数据。
Assistant: 我将检索三星电子 (005930) 过去一个月的 OHLCV 数据。

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

推荐服务器

Crypto Price & Market Analysis MCP Server

一个模型上下文协议 (MCP) 服务器，它使用 CoinCap API 提供全面的加密货币分析。该服务器通过一个易于使用的界面提供实时价格数据、市场分析和历史趋势。 (Alternative, slightly more formal and technical translation): 一个模型上下文协议 (MCP) 服务器，利用 CoinCap API 提供全面的加密货币分析服务。该服务器通过用户友好的界面，提供实时价格数据、市场分析以及历史趋势数据。

精选

TypeScript