Korea Investment MCP Server（韩国投资证券MCP服务器）
该项目是利用韩国投资证券OpenAPI提供股票和衍生产品信息的模型上下文协议（MCP）服务器。
自制 @jissp/nestjs-mcp服务器 使用了，AI模型可以直接利用韩国投资证券的实时股价查询、排名分析、投资者交易趋势等数据。
主要特点
- 基于NestJS：可扩展、易于维护的体系结构
- @jissp/nestjs-mcp服务器：使用您自己创建的NestJS MCP库
- 支持服务器-发送事件（SSE）：优化实时数据传输
- 各种金融数据：提供股票、期货、期权、投资者趋势等全面API
先决条件（Prerequisites）
- 韩国投资证券API账户: 韩国投资证券API门户网站您需要在中获得应用程序密钥（App Key）和应用程序秘密（App Secret）。
- Node.js：必须安装v18或更高版本的Node.js。
安装和设置
1.项目安装
npm install2.设置环境变量
在项目根目录中 .env 创建文件或将以下值设置为系统环境变量：
KOREA_INVESTMENT_HOST=https://openapi.koreainvestment.com:9443
KOREA_INVESTMENT_APP_KEY=여러분의_APP_KEY
KOREA_INVESTMENT_APP_SECRET=여러분의_APP_SECRET
KOREA_INVESTMENT_USER_ID=여러분의_HTS_ID3.构建和运行项目
# 빌드
npm run build
# 서버 실행
npm run start:prod______________________________________________________________________
如何在Claude Code中设置
这台服务器 SSE（服务器发送事件） 通过这种方式支持MCP协议。要在Claude Code（CLI）中使用此服务器，必须先运行服务器，然后添加设置。
1.运行服务器
启动终端或Docker容器以运行服务器。
npm run start:prod或
docker compose up -d服务器基本上 http://localhost:3000在中工作，MCP端点 http://localhost:3000/mcp是。
2.将MCP添加到Claude Code
打开新的终端窗口，并打开Claude Code配置文件（~/.claude/settings.local.json）添加以下内容： claude mcp add 使用功能。
方法A：直接修改配置文件 ~/.claude/settings.local.json （或项目的 .claude/settings.local.json）打开文件并添加以下内容：
{
"mcpServers": {
"korea-investment": {
"url": "http://localhost:3000/mcp"
}
}
}方法B:Claude Desktop设置（MacOS/Windows） 对于Claude Desktop用户： claude_desktop_config.json 添加到文件。
{
"mcpServers": {
"korea-investment": {
"url": "http://localhost:3000/mcp"
}
}
}______________________________________________________________________
数据管理（更新代码文件）
要使主文件（如股票代码或行业代码）保持最新状态，请执行以下命令：
npm run update-mst该命令从韩国投资证券服务器下载最新的主文件， src/common/assets/*.json 更新文件。
______________________________________________________________________
使用方法
查询项目信息
帮我查询一下三星电子项目的信息。
⏺ KoreaInvestmentMcp - search-stock-info (MCP)(PDNO: "005930", PRDT_TYPE_CD: "300")
⎿ {
"output": {
"pdno": "00000A005930",
… +71 lines (ctrl+o to expand)
⏺ 삼성전자 종목 정보를 조회했습니다.
주요 정보
기본 정보
- 종목명: 삼성전자
- 영문명: Samsung Electronics
- 종목코드: 005930 (KR7005930003)
- 종목구분: 주식(보통주)
시가총액 규모
- 상장주식수: 5,919,637,922주
- 시가총액: 778,046,685,000,000원 (약 778조)
- 액면가: 100원
현재 주가
- 현재가: 190,000원
- 기준일: 2026년 3월 11일
산업 분류
- 표준산업분류: 통신 및 방송 장비 제조업
- 지수분류:
- 시가총액 규모: 대형주
- 산업: 전기, 전자
거래 정보
- 거래 중지 여부: 거래 가능
- 행정 조치: 없음
- 전자증권: 적용됨
기타
- 상장일: 1975년 6월 11일
- KOSPI200 구성 여부: 포함
- 대차거래 가능: 가능
삼성전자는 한국 주식시장의 최대 규모 우량주이며, 현재 190,000원에 거래되고 있습니다.______________________________________________________________________
主要功能（Tools）
该服务器为AI模型提供以下工具：
1.查询股票和指数
inquire-index-price：查询国内行业指数的现价。inquire-index-daily-price：按行业按日期查询行情。search-stock-info：查询股票的基本信息（商品类型、股票代码等）。intstock-multi-price：一次查看多个感兴趣项目的当前价格。
2.投资者买卖动向及市场分析
investor-trade-by-stock-daily：分析特定股票的每日投资者交易趋势。investor-daily-by-market：查询各市场（KOSPI/COSDAQ等）投资者的交易动向。hts-top-view：提供HTS各屏幕的热门浏览项目排名。
3.统计和排名
volume-rank：查询基于交易量的股票排名。fluctuation-rank：查询基于涨跌率的项目排名。credit-balance-rank：查询信用融资余额排名靠前的项目。short-sale-rank：查询卖空余额排名靠前的项目。
4.其他现状
daily-credit-balance：查询每日信贷余额趋势。daily-short-sale：查询每日卖空交易情况。daily-loan-trans：查询每日借贷交易情况。
5.派生商品
future-option-price：期货/期权查询当前市价。future-option-period-price：查询期货/期权的历史行情。