kospi-kosdaq-stock-server

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

功能特点

• 查询KOSPI/KOSDAQ的股票代码和名称
• 获取特定股票的OHLCV数据（开盘价、最高价、最低价、收盘价、成交量）
• 获取特定股票的市场资本化数据
• 获取特定股票的基本面数据（市盈率/市净率/股息收益率）
• 获取特定股票按投资者类型分类的交易量数据

可用工具

• 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（字符串，必填）：股票代码

安装

此包需要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服务器。

1. 定位配置文件：

   • 在macOS上，该文件通常位于：
     /Users/用户名/Library/Application Support/Claude/claude_desktop_config.json
   • 在Windows上，该文件通常位于：
     %APPDATA%/Claude/claude_desktop_config.json

2. 添加服务器配置：
   打开claude_desktop_config.json文件，并在mcpServers对象中添加一个新条目：

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

配置详情：

• command：使用uvx以利用uv的隔离和依赖管理功能
• args：由于入口点已在包中定义，只需提供包名
• 不需要额外的环境变量

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

使用示例

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

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

用户：请加载所有可用的股票代码。
助手：我将帮助您加载所有KOSPI和KOSDAQ的股票代码。

> 使用工具'load_all_tickers'...
成功加载了2,873个股票代码。

2. 获取特定股票的OHLCV数据：

用户：显示三星电子过去一个月的股票数据。
助手：我将检索三星电子（005930）过去一个月的OHLCV数据。

> 使用工具'get_stock_ohlcv'...
日期        开盘价    最高价    最低价    收盘价    成交量
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
...