Pykrx MCP

基于pykrx的MCP服务器，为AI代理提供韩国股市数据查询功能，支持股价、财务指标、投资者交易、卖空数据等多维度分析。

金融研究与数据 #韩国股市 #AI代理 #数据查询 #MCP服务 .Python

评分 : 2分

下载量 : 5.3K

更新时间 : 2026-03-13

打开站点

什么是pykrx-mcp?

pykrx-mcp是一个基于Model Context Protocol (MCP)的服务器，专门为AI助手（如ChatGPT和Claude）提供韩国股票市场数据。它允许用户使用自然语言查询韩国三大交易所（KOSPI、KOSDAQ、KONEX）的各种金融数据，无需记忆复杂的API语法。

如何使用pykrx-mcp?

通过简单的配置，将pykrx-mcp服务器集成到Claude Desktop中，然后就可以像聊天一样询问股票数据。例如，直接问“三星电子最近一个月的股价是多少？”或“KOSPI指数今天的表现如何？”。

适用场景

适合投资者、分析师、学生以及任何需要快速获取韩国股票市场信息的人。无论是进行投资分析、市场研究、学术项目还是日常投资决策，都可以通过AI助手轻松获取所需数据。

主要功能

股票数据

提供个股价格、交易量、市值、财务指标（PER、PBR、EPS等）的查询功能。

指数数据

查询KOSPI、KOSDAQ等市场指数的价格走势、成分股和基本面指标。

投资者分析

分析机构、外国投资者、个人投资者等不同群体的买卖动向和资金流向。

卖空数据

提供个股卖空交易量、卖空余额和卖空比例等数据，帮助识别市场情绪。

ETF数据

查询交易所交易基金（ETF）的价格、交易量和基本信息。

自然语言接口

无需学习复杂命令，使用日常语言即可查询所有数据，降低使用门槛。

优势

用户友好：使用自然语言查询，无需技术背景

数据全面：覆盖韩国三大交易所的多种数据类型

实时性：基于KRX官方数据，信息及时准确

集成方便：轻松集成到Claude和ChatGPT等AI平台

免费开源：基于MIT许可证，可自由使用和修改

局限性

仅支持韩国股票市场数据，不包含其他国际市场

需要Claude Desktop或支持MCP的AI平台才能使用

数据更新频率受KRX数据发布时间的限制

高级分析功能需要用户自行组合查询

如何使用

安装pykrx-mcp

通过MCP Registry一键安装或使用pip/uv手动安装。

配置Claude Desktop

修改Claude Desktop的配置文件，添加pykrx-mcp服务器配置。

重启并开始使用

重启Claude Desktop，然后就可以在聊天中直接询问股票数据了。

使用案例

个股价格分析

投资者想了解三星电子最近的市场表现，包括价格走势和交易量变化。

财务指标比较

分析师需要比较几家科技公司的估值水平，以做出投资决策。

市场情绪分析

交易员想了解外资对韩国市场的看法，通过外资买卖行为判断市场情绪。

卖空监控

风险管理者需要监控市场中卖空活动异常活跃的股票。

常见问题

pykrx-mcp是免费的吗？

需要编程知识才能使用吗？

数据更新频率是多少？

支持实时股价吗？

可以在ChatGPT中使用吗？

数据准确吗？

🚀 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/股息收益率