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