pykrx-mcp
PyPI version
ํ๊ตญ ์ฃผ์ ์์ฅ ๋ฐ์ดํฐ๋ฅผ AI ์์ด์ ํธ์๊ฒ ์ ๊ณตํ๋ MCP (Model Context Protocol) ์๋ฒ์
๋๋ค.
pykrx ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ๊ธฐ๋ฐ์ผ๋ก KOSPI, KOSDAQ, KONEX ์์ฅ์ ์ฃผ๊ฐ, ์ฌ๋ฌด์ ํ, ํฌ์์๋ณ ์๊ธ, ๊ณต๋งค๋ ๋ฑ ๋ค์ํ ๋ฐ์ดํฐ๋ฅผ ChatGPT์ Claude์์ ์์ฐ์ด๋ก ์กฐํํ ์ ์์ต๋๋ค.
โ ํ์ํ๊ธฐ
ํ๋ก์ ํธ๊ฐ ๋์์ด ๋์๋ค๋ฉด ๊ฐ๋ฐ์๋ฅผ ์์ํด์ฃผ์ธ์!
1. ์์ํ๊ธฐ
1.1 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์ ์ฌ์์ํ๋ฉด ๋ฐ๋ก ์ฌ์ฉํ ์ ์์ต๋๋ค.
2. ์ง์ํ๋ ๋ฐ์ดํฐ ๋ฐ API
๋ชจ๋ API๋ pykrx ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๋ฅผ ๊ธฐ๋ฐ์ผ๋ก ๊ตฌํ๋์์ต๋๋ค.
2.1 ์ฃผ์ ๋ฐ์ดํฐ (Stock Data)
2.1.1 ์ข
๋ชฉ ์ ๋ณด
get_market_ticker_list: ์์ฅ๋ณ ์ข
๋ชฉ ์ฝ๋ ์กฐํ
get_market_ticker_name: ์ข
๋ชฉ ์ฝ๋๋ก ์ข
๋ชฉ๋ช
์กฐํ
2.1.2 ๊ฐ๊ฒฉ ๋ฐ์ดํฐ
get_stock_ohlcv: ๊ฐ๋ณ ์ข
๋ชฉ OHLCV (์๊ฐ/๊ณ ๊ฐ/์ ๊ฐ/์ข
๊ฐ/๊ฑฐ๋๋)
get_market_ohlcv_by_date: ํน์ ์ผ์ ์ ์ข
๋ชฉ ์์ธ
get_market_price_change: ๊ธฐ๊ฐ๋ณ ์ ์ข
๋ชฉ ๊ฐ๊ฒฉ ๋ณ๋
2.1.3 ์๊ฐ์ด์ก
get_market_cap_by_date: ๊ฐ๋ณ ์ข
๋ชฉ ์๊ฐ์ด์ก ์กฐํ
2.1.4 ์ฌ๋ฌด ์งํ
get_market_fundamental_by_date: PER, PBR, EPS, DIV, BPS, DPS
2.1.5 ํฌ์์๋ณ ๊ฑฐ๋
get_market_trading_value_by_date: ์ข
๋ชฉ๋ณ ํฌ์์ ์๊ธ (๊ฑฐ๋๋๊ธ)
get_market_trading_volume_by_investor: ํฌ์์๋ณ ๊ฑฐ๋๋
get_market_trading_value_by_investor: ํฌ์์๋ณ ๊ฑฐ๋๋๊ธ
get_market_net_purchases_of_equities: ํฌ์์๋ณ ์๋งค์ ์์ ์ข
๋ชฉ
2.2 ์ง์ ๋ฐ์ดํฐ (Index Data)
2.2.1 ์ง์ ์ ๋ณด
get_index_ticker_list: ์ง์ ํฐ์ปค ๋ชฉ๋ก
get_index_ticker_name: ์ง์ ์ด๋ฆ ์กฐํ
get_index_portfolio_deposit_file: ์ง์ ๊ตฌ์ฑ ์ข
๋ชฉ
2.2.2 ์ง์ ๊ฐ๊ฒฉ
get_index_ohlcv: ์ง์ OHLCV ๋ฐ์ดํฐ
2.2.3 ์ง์ ์งํ
get_index_fundamental: ์ง์ PER/PBR/๋ฐฐ๋น์์ต๋ฅ
2.3 ๊ณต๋งค๋ ๋ฐ์ดํฐ (Short Selling)
get_shorting_status_by_date: ์ข
๋ชฉ๋ณ ๊ณต๋งค๋ ํํฉ
get_shorting_volume_by_ticker: ์ ์ข
๋ชฉ ๊ณต๋งค๋ ๊ฑฐ๋๋
get_shorting_balance_top50: ๊ณต๋งค๋ ์๊ณ ์์ 50
get_shorting_volume_top50: ๊ณต๋งค๋ ๊ฑฐ๋ ๋น์ค ์์ 50
2.4 ์ธ๊ตญ์ธ ํฌ์ (Foreign Investment)
get_exhaustion_rates_of_foreign_investment: ์ธ๊ตญ์ธ ๋ณด์ ๋ ๋ฐ ํ๋์์ง๋ฅ
2.5 ETF ๋ฐ์ดํฐ
get_etf_ticker_list: ETF ์ข
๋ชฉ ๋ฆฌ์คํธ
get_etf_ohlcv_by_date: ETF OHLCV ๋ฐ์ดํฐ
์ด 23๊ฐ์ ๋ฐ์ดํฐ ์กฐํ ๋๊ตฌ ์ง์
3. ์ฌ์ฉ ์์
3.1 ์ฃผ๊ฐ ์กฐํ
๊ฐ๋ณ ์ข
๋ชฉ ์ฃผ๊ฐ
"์ผ์ฑ์ ์ ์ต๊ทผ ํ๋ฌ ์ฃผ๊ฐ ๋ณด์ฌ์ค"
"SKํ์ด๋์ค 2024๋
1์ OHLCV ๋ฐ์ดํฐ"
"์นด์นด์ค ์ง๋์ฃผ ์ฃผ๊ฐ ์์ง์ ๋ถ์ํด์ค"
์์ฅ ์ ์ฒด ์์ธ
"์ฝ์คํผ ์ ์ข
๋ชฉ ์ค๋ ์์ธ ๋ณด์ฌ์ค"
"์ฝ์ค๋ฅ ์์ 10๊ฐ ์ข
๋ชฉ ๊ฐ๊ฒฉ ๋ณ๋๋ฅ "
3.2 ์๊ฐ์ด์ก & ๊ฑฐ๋๋
"์ผ์ฑ์ ์ ์๊ฐ์ด์ก์ด ์ผ๋ง์ผ?"
"์ผ์ฑ์ ์ ์ต๊ทผ ํ๋ฌ ๊ฑฐ๋๋ ์ถ์ด"
"๋ค์ด๋ฒ ๊ฑฐ๋๋๊ธ ๋ถ์ํด์ค"
3.3 ์ฌ๋ฌด ์งํ
"์ผ์ฑ์ ์ PER, PBR ์๋ ค์ค"
"์ผ์ฑ์ ์ ๋ฐฐ๋น์์ต๋ฅ ์ผ๋ง์ผ?"
"๋ค์ด๋ฒ ์ต๊ทผ EPS๋?"
3.4 ํฌ์์๋ณ ์๊ธ ๋ถ์
"์ผ์ฑ์ ์ ์ธ๊ตญ์ธ ๋งค์์ธ ์ด๋?"
"์นด์นด์ค ์ต๊ทผ ๊ธฐ๊ด ์๊ธ ๋ถ์"
"์ฝ์คํผ ๊ฐ์ธ ํฌ์์๊ฐ ๋ง์ด ์ฐ ์ข
๋ชฉ"
"์ธ๊ตญ์ธ์ด ์๋งค์ํ ์์ 10๊ฐ ์ข
๋ชฉ"
3.5 ๊ณต๋งค๋ ๋ถ์
"์ผ์ฑ์ ์ ๊ณต๋งค๋ ๋น์ค ์ผ๋ง์ผ?"
"์ฝ์คํผ ๊ณต๋งค๋ ์์ ์ข
๋ชฉ ์๋ ค์ค"
"๊ณต๋งค๋ ์๊ณ ๊ฐ ๊ฐ์ฅ ๋์ ์ข
๋ชฉ์?"
3.6 ์ง์ ์กฐํ
"์ฝ์คํผ ์ง์ ์ต๊ทผ ํ๋ฌ ์ถ์ด"
"์ฝ์ค๋ฅ 150 ์ง์ PER์?"
"๋ฐ๋์ฒด ์นํฐ ์ง์ ๊ตฌ์ฑ ์ข
๋ชฉ ์๋ ค์ค"
3.7 ์ธ๊ตญ์ธ ํฌ์
"์ผ์ฑ์ ์ ์ธ๊ตญ์ธ ๋ณด์ ๋น์ค์?"
"์ธ๊ตญ์ธ ํ๋์์ง๋ฅ ๋์ ์ข
๋ชฉ"
3.8 ์ข
๋ชฉ ๊ฒ์
"์ฝ์คํผ ์ข
๋ชฉ ๋ฆฌ์คํธ"
"005930 ์ข
๋ชฉ๋ช
์ด ๋ญ์ผ?"
"์ค๋ ๊ฑฐ๋๋ ETF ๋ฆฌ์คํธ"
4. ์ฃผ์ ํน์ง
4.1 ์์ฐ์ด ๋ํํ ์ธํฐํ์ด์ค
๋ณต์กํ API ๋ฌธ๋ฒ ์์ด ์ผ์ ์ธ์ด๋ก ๋ฐ์ดํฐ๋ฅผ ์กฐํํ ์ ์์ต๋๋ค.
4.2 ์ค์๊ฐ ํ๊ตญ ์ฃผ์ ์์ฅ ๋ฐ์ดํฐ
KRX(ํ๊ตญ๊ฑฐ๋์)์ ์ต์ ๋ฐ์ดํฐ๋ฅผ ์ ๊ณตํฉ๋๋ค.
4.3 ๋ค์ํ ๋ถ์ ๊ธฐ๋ฅ
๊ฐ๊ฒฉ ์ถ์ด ๋ถ์
ํฌ์์๋ณ ์๊ธ ๋ถ์
์ฌ๋ฌด ์งํ ๋น๊ต
๊ณต๋งค๋ ํํฉ ๋ถ์
4.4 AI ์์ด์ ํธ ์ต์ ํ
ChatGPT์ Claude์์ ๋ฐ๋ก ์ฌ์ฉํ ์ ์๋๋ก MCP ํ๋กํ ์ฝ์ ์ง์ํฉ๋๋ค.
5. ๊ธฐ์ ์คํ
Python 3.10+
pykrx : ํ๊ตญ ์ฃผ์ ์์ฅ ๋ฐ์ดํฐ ์์ง
FastMCP : MCP ์๋ฒ ํ๋ ์์ํฌ
MCP (Model Context Protocol) : AI ์์ด์ ํธ์์ ํต์ ํ๋กํ ์ฝ
6. ๊ฐ๋ฐ์ ์ ๋ณด
6.1 ๋ก์ปฌ ๊ฐ๋ฐ ํ๊ฒฝ ์ค์
์์ธํ ๋ด์ฉ์ 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
6.2 ๊ธฐ์ฌํ๊ธฐ
์ด์ ๋ฐ ํ ๋ฆฌํ์คํธ๋ฅผ ํ์ํฉ๋๋ค!
7. ๋ผ์ด์ ์ค
MIT License - ์์ ๋กญ๊ฒ ์ฌ์ฉํ์ธ์!
8. ๊ด๋ จ ํ๋ก์ ํธ
pykrx : ํ๊ตญ ์ฃผ์ ์์ฅ ๋ฐ์ดํฐ ์์ง ๋ผ์ด๋ธ๋ฌ๋ฆฌ (๋ณธ ํ๋ก์ ํธ์ ๊ธฐ๋ฐ)
MCP : Model Context Protocol ๊ณต์ ๋ฌธ์