kospi-kosdaq-stock-server

<a href="https://glama.ai/mcp/servers/i1judi5h55"> <img width="380" height="200" src="https://gips3.baidu.com/it/u=4013829480,4047378810&fm=3081&app=3081&f=PNG?w=760&h=400" /> </a>

这是一个使用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 自动安装 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/username/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. 首先，加载所有可用的股票代码：

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

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

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

Human: 显示三星电子过去一个月的股票数据。
Assistant: 我会检索三星电子（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
...