内容
# 韩国股票MCP
네이버金融数据通过MCP(Model Context Protocol)暴露的Node.js服务器。
Claude Desktop, Cursor等MCP客户端可以直接查询韩国ETF / 主题 / 市值 / 分红 / 个别股票价格。
## 功能(工具)概要
1. **获取市值排名前列的ETF**
- `https://finance.naver.com/sise/etf.naver`
- 按市值顺序获取ETF列表。
- 输入
- `limit` (数字,可选,默认50):最大结果数量
- 输出
- `items[]`:`{ 名称, 代码, 当前价格, NAV, 涨跌幅 }`
2. **获取主题及领涨股票**
- `https://finance.naver.com/sise/theme.naver`
- 获取昨日涨幅排名前列的主题,并返回各主题的领涨股票名称。
- 输入
- `limit` (数字,可选,默认50)
- 输出
- `items[]`:`{ 主题名称, 主题ID, 涨跌幅, 领涨股票[] }`
3. **获取市值排名前列的股票**
- `https://finance.naver.com/sise/sise_market_sum.naver`
- 按市值顺序获取股票名称和当前价格信息。
- 输入
- `sosok` (数字,可选):0= 코스피,1= 코스닥 (默认0)
- `page` (数字,可选,默认1)
- `limit` (数字,可选,默认50)
- 输出
- `items[]`:`{ 名称, 代码, 当前价格 }`
4. **获取分红收益率排名前列的股票**
- `https://finance.naver.com/sise/dividend_list.naver`
- 按分红收益率顺序获取股票信息。
- 输入
- `page` (数字,可选,默认1)
- `limit` (数字,可选,默认50)
- 输出
- `items[]`:`{ 名称, 代码, 当前价格, 分红, 分红收益率 }`
5. **搜索股票代码**
- `https://finance.naver.com/search/search.naver?query={股票名称}`
- 通过股票名称搜索获取股票代码。
- 输入
- `query` (字符串):股票名称(例:“삼성전자”)
- 输出
- `result`:`{ 名称, 代码 }` 或 `null`
6. **获取股票代码的当前价格**
- `https://finance.naver.com/item/main.naver?code={股票代码}`
- 通过股票代码获取当前价格信息。
- 输入
- `code` (字符串):6位股票代码(例:“005930”)
- 输出
- `{ 名称, 代码, 当前价格 }`
> 所有工具均以`structuredContent`返回JSON格式结果,并在`content[0].text`中包含pretty-printed JSON字符串。MCP客户端可以使用任意一种格式。
---
## 安装和运行
### 1) 本地开发
```bash
# 项目初始化
npm install
# 运行MCP服务器(STDIO)
node index.js
```
或
```bash
npm start
```
### 2) 使用npx运行
如果已将软件包发布到npm,则可以在其他环境中使用以下命令运行:
```bash
npx korea-stock-mcp
```
(在本地测试时,可以使用`npm link`全局链接后运行`npx korea-stock-mcp`或`korea-stock-mcp`)
---
## Claude Desktop集成示例
- 修改`claude_desktop_config.json`文件。
```
{
"mcpServers": {
"korea-stock-mcp": {
"command": "npx",
"args": ["-y", "@drfirst/korea-stock-mcp@latest"]
}
}
}
```
---
## 使用示例
示例提示:
> 使用korea-stock-mcp查询今日的主要主题和该主题的股票
> 使用korea-stock-mcp查询今日的ETF信息
> 使用korea-stock-mcp按市值顺序查询今日的股票
> 使用korea-stock-mcp查询TLB的当前价格