AI导哈

韩国股票数据服务

一个基于Node.js的服务器，通过MCP协议提供Naver金融数据，支持查询韩国ETF、主题、市值、股息和个股价格。

  • by DrFirstLee
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 DrFirstLee/korea-stock-mcp

使用说明

韩国股票mcp

基于Node.js的服务器，将NAVER金融数据公开为模型上下文协议（MCP）。
Claude Desktop、Cursor等MCP客户端可以直接查询韩国ETF/主题/市价总额/分红/个股价格。

功能（工具）摘要

  1. get_etfs_by_market_cap

    • https://finance.naver.com/sise/etf.naver
    • 按市价总额顺序获取ETF列表。
    • 输入
      • limit （number，optional，default 50）：最大结果数
    • 输出
      • items[]: { name, code, currentPrice, nav, changeRate }

  2. get_themes_with_leaders

    • https://finance.naver.com/sise/theme.naver
    • 按照与前一天相比上升较高的顺序导入主题，并同时返回每个主题的主导项目名称。
    • 输入
      • limit （数字，可选，默认50）
    • 输出
      • items[]: { themeName, themeId, changeRate, leaders[] }

  3. get_market_cap_stocks

    • https://finance.naver.com/sise/sise_market_sum.naver
    • 按市价总额顺序获取项目名称和当前价格信息。
    • 输入
      • sosok （number，optional）：0=KOSPI，1=KOSDAQ（默认为0）
      • page （number，optional，默认1）
      • limit （number，optional，默认50）
    • 输出
      • items[]: { name, code, currentPrice }

  4. get_dividend_yield_stocks

    • https://finance.naver.com/sise/dividend_list.naver
    • 股息收益率按高顺序获取股票信息。
    • 输入
      • page （number，optional，默认1）
      • limit （number，optional，默认50）
    • 输出
      • items[]: { name, code, currentPrice, dividend, dividendYield }

  5. search_stock_code

    • https://finance.naver.com/search/search.naver?query={종목명}
    • 按项目名称搜索并获取项目代码。
    • 输入
      • query （string）：项目名称（例如： "삼성전자")
    • 输出
      • result: { name, code } 或 null

  6. get_stock_price_by_code

    • https://finance.naver.com/item/main.naver?code={종목코드}
    • 当前作为项目代码获取信息。
    • 输入
      • code （string）：6位项目代码（例如： "005930")
    • 输出
      • { name, code, currentPrice }

所有工具 structuredContent 将JSON格式结果， content[0].text 返回pretty-包含printed JSON字符串。MCP客户端可以使用两种方便的形式。

安装和运行

1）用于本地开发

# 프로젝트 초기화
npm install

# MCP 서버 실행 (STDIO)
node index.js

或

npm start

2）以npx运行

如果已将包分发到npm，则可以在其他环境中执行以下操作：

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了解蒂尔比的市价

相关 MCP