pykrx-mcp

🚀 pykrx-mcp

pykrx-mcp是一个基于MCP（Model Context Protocol）的服务器，它能为AI智能体提供韩国股票市场数据。借助 pykrx 库，用户可以通过ChatGPT和Claude等工具，以自然语言的方式查询KOSPI、KOSDAQ、KONEX市场的股票价格、财务报表、投资者供需、卖空等各类数据。

🚀 快速开始

Claude Desktop中使用

自动安装（推荐）

通过MCP Registry一键安装：

npx @modelcontextprotocol/inspector install pykrx-mcp

手动安装

手动修改Claude Desktop的配置文件：

• macOS/Linux：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pykrx": {
      "command": "uvx",
      "args": ["pykrx-mcp"]
    }
  }
}

配置完成后，重启Claude Desktop即可使用。

✨ 主要特性

自然语言对话式界面

无需复杂的API语法，使用日常语言就能查询数据。

实时韩国股票市场数据

提供KRX（韩国证券交易所）的最新数据。

多样化分析功能

• 价格趋势分析
• 投资者供需分析
• 财务指标比较
• 卖空情况分析

AI智能体优化

支持MCP协议，可直接在ChatGPT和Claude中使用。

📦 安装指南

本地开发环境配置

具体内容请参考 DEVELOPMENT.md。

# 克隆仓库
git clone https://github.com/sharebook-kr/pykrx-mcp.git
cd pykrx-mcp

# 安装依赖
uv pip install -e ".[dev]"

# 运行测试
uv run pytest

# 启动服务器
uv run pykrx-mcp

💻 使用示例

股价查询

个别股票股价

"显示三星电子最近一个月的股价"
"获取SK海力士2024年1月的OHLCV数据"
"分析 Kakao 上周的股价走势"

市场整体行情

"显示今日KOSPI所有股票的行情"
"KOSDAQ前10名股票的价格变动率"

市值与交易量

"三星电子的市值是多少？"
"三星电子最近一个月的交易量趋势"
"分析 Naver 的交易金额"

财务指标

"告诉我三星电子的PER和PBR"
"三星电子的股息收益率是多少？"
"Naver 最近的 EPS 是多少？"

投资者供需分析

"三星电子的外国投资者买入情况如何？"
"分析 Kakao 最近的机构供需情况"
"KOSPI 中个人投资者大量买入的股票"
"外国投资者净买入的前10名股票"

卖空分析

"三星电子的卖空比例是多少？"
"告诉我KOSPI卖空排名靠前的股票"
"卖空余额最高的股票是哪只？"

指数查询

"KOSPI指数最近一个月的走势"
"KOSDAQ 150指数的PER是多少？"
"告诉我半导体板块指数的成分股"

外国投资

"三星电子的外国投资者持股比例是多少？"
"外国投资者限额耗尽率高的股票"

股票搜索

"KOSPI股票列表"
"005930 是什么股票？"
"今天交易的ETF列表"

📚 详细文档

支持的数据和API

所有API均基于 pykrx库 实现。

股票数据（Stock Data）

• 股票信息
  • get_market_ticker_list：按市场查询股票代码
  • get_market_ticker_name：通过股票代码查询股票名称
• 价格数据
  • get_stock_ohlcv：单个股票的OHLCV（开盘价/最高价/最低价/收盘价/交易量）
  • get_market_ohlcv_by_date：特定日期所有股票的行情
  • get_market_price_change：所有股票的期间价格变动
• 市值
  • get_market_cap_by_date：查询单个股票的市值
• 财务指标
  • get_market_fundamental_by_date：PER、PBR、EPS、DIV、BPS、DPS
• 投资者交易
  • get_market_trading_value_by_date：按股票的投资者供需（交易金额）
  • get_market_trading_volume_by_investor：按投资者的交易量
  • get_market_trading_value_by_investor：按投资者的交易金额
  • get_market_net_purchases_of_equities：投资者净买入排名靠前的股票

指数数据（Index Data）

• 指数信息
  • get_index_ticker_list：指数代码列表
  • get_index_ticker_name：查询指数名称
  • get_index_portfolio_deposit_file：指数成分股
• 指数价格
  • get_index_ohlcv：指数OHLCV数据
• 指数指标
  • get_index_fundamental：指数PER/PBR/股息收益率

卖空数据（Short Selling）

• get_shorting_status_by_date：按股票的卖空情况
• get_shorting_volume_by_ticker：所有股票的卖空交易量
• get_shorting_balance_top50：卖空余额前50名
• get_shorting_volume_top50：卖空交易比例前50名

外国投资（Foreign Investment）

• get_exhaustion_rates_of_foreign_investment：外国投资者持股量及限额耗尽率

ETF数据

• get_etf_ticker_list：ETF股票列表
• get_etf_ohlcv_by_date：ETF的OHLCV数据

共支持23种数据查询工具

🔧 技术细节

• Python 3.10+
• pykrx：韩国股票市场数据收集
• FastMCP：MCP服务器框架
• MCP (Model Context Protocol)：与AI智能体的通信协议

📄 许可证

本项目采用MIT许可证，你可以自由使用！

🌟 相关项目

• pykrx：韩国股票市场数据收集库（本项目的基础）
• MCP：Model Context Protocol官方文档

☕ 支持我们

如果本项目对你有帮助，请支持开发者！

👥 贡献

欢迎提交问题和拉取请求！