kospi-kosdaq股票服务器

Name: kospi-kosdaq
Author: dragon1086

PyPI 版本铁匠徽章

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

特征

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

Related MCP server: Stock Info Service

可用工具

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

手动安装

# Create and activate a virtual environment uv venv .venv source .venv/bin/activate # On Unix/macOS # .venv\Scripts\activate # On Windows # Install the package 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: 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.

获取特定股票的 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 ...