](https://mseep.ai/app/dragon1086-kospi-kosdaq-stock-server)
kospi kosdaq股票服务器
](https://badge.fury.io/py/kospi-kosdaq-stock-server) ](https://smithery.ai/server/@dragon1086/kospi-kosdaq-stock-server)
使用FastMCP提供KOSPI/KOSDAQ股票数据的MCP服务器。 提供KOSPI/KOSDAQ股票数据的MCP服务器。
______________________________________________________________________
🇰🇷 韩语(Korean)
介绍
这台服务器 模型上下文协议(MCP) 通过,AI模型(Claude、Antigravity等)可以查询韩国股市(KOSPI、KOSDAQ)的实时数据。
主要功能
- 搜索项目:查询KOSPI/KOSDAQ全部项目的票据(代码)和名称
- 查询股价(OHLCV):查询特定股票的市价、高价、低价、收盘价、成交量数据
- 查询市价总额:查询市价总额、交易金额、上市股票数量
- 基本面查询:查询PER、PBR、股息收益率等投资指标
- 各投资者的交易量:查询个人、外国人、机构等投资者的交易动向
- 指数查询:KOSPI,KOSDAQ指数数据查询
安装方法(Installation)
此软件包是一个Python软件包管理工具。 紫外线 使用。
1.事前准备(Prerequisites)
uv必须安装。
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"2.自动安装(使用Smithery)
如果您使用Claude Desktop,可以通过Smithery一次性安装。
npx -y @smithery/cli install @dragon1086/kospi-kosdaq-stock-server --client claude3.手动安装(Manual)
要直接安装和使用,请运行以下命令。
# 가상환경 생성 및 활성화
uv venv .venv
source .venv/bin/activate # macOS/Linux
# .venv\Scripts\activate # Windows
# 패키지 설치
uv pip install kospi-kosdaq-stock-server配置(Configuration)
Antigravity(或常规MCP客户端)
在Antigravity设置菜单(Settings>MCP Servers)中输入以下信息。 包含脚本以实现更轻松的执行(run_server.sh 或者 run_server.bat)。
macOS/Linux:
- 命令:
/Users/admin/Documents/kospi-kosdaq-stock-server/run_server.sh - 参数:(空)
- 当前工作目录:
/Users/admin/Documents/kospi-kosdaq-stock-server
窗户:
- 命令:
C:\path\to\kospi-kosdaq-stock-server\run_server.bat
- (项目路径中的 run_server.bat 文件的绝对路径)
- 参数:(空)
- 当前工作目录:
C:\path\to\kospi-kosdaq-stock-server
- (项目文件夹的绝对路径)
克劳德桌面版
claude_desktop_config.json 请打开文件添加以下内容。
{
"mcpServers": {
"kospi-kosdaq": {
"command": "uv",
"args": ["run", "kospi_kosdaq_stock_server.py"],
"cwd": "/absolute/path/to/kospi-kosdaq-stock-server"
}
}
}*注意: /absolute/path/to/... 必须将部分更改为实际项目路径。对于Windows,请使用路径分隔符 \\ 或者 /请使用。*
______________________________________________________________________
🇺🇸 英语
引言
此MCP服务器使AI模型(如Claude、Antigravity)能够访问韩国股市(KOSPI、KOSDAQ)的实时数据。
特性
- 票务查询:检索所有KOSPI/KOSDAQ股票的股票代码和名称。
- OHLCV数据:获取特定股票的开盘价、最高价、最低价、收盘价和成交量数据。
- 市值:检索市值、交易价值和上市股票。
- 基础:访问PER、PBR、股息收益率和其他投资指标。
- 投资者交易量:按投资者类型(个人、外国人、机构)划分的交易量明细。
- 索引数据:检索KOSPI和KOSDAQ指数数据。
安装
此程序包需要 紫外线.
1.先决条件
确保 uv 已安装。
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"2.自动安装(通过Smithery)
要自动安装Claude Desktop,请执行以下操作:
npx -y @smithery/cli install @dragon1086/kospi-kosdaq-stock-server --client claude3.手动安装
# Create and activate virtual environment
uv venv .venv
source .venv/bin/activate # macOS/Linux
# .venv\Scripts\activate # Windows
# Install package
uv pip install kospi-kosdaq-stock-server配置
适用于反重力(和其他MCP客户端)
使用附带的脚本(run_server.sh 对于macOS/Linux, run_server.bat 适用于Windows)。
macOS/Linux:
- 命令:
/path/to/project/run_server.sh - 参数:(留空)
- 当前工作目录:
/path/to/project
窗户:
- 命令:
C:\path\to\project\run_server.bat - 参数:(留空)
- 当前工作目录:
C:\path\to\project
适用于克劳德桌面
将以下内容添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"kospi-kosdaq": {
"command": "uv",
"args": ["run", "kospi_kosdaq_stock_server.py"],
"cwd": "/absolute/path/to/kospi-kosdaq-stock-server"
}
}
}______________________________________________________________________
Usage Example(使用示例)
1.加载Tickers(加载项目)
用户:“请加载所有可用的股票代码。” (用户:“请调出所有股票股票信息。”)
2.Get Stock Data(查询股价)
用户:“给我看看三星电子上个月的股票数据。” (用户:“让我们看看三星电子上个月的股价走势。”)
