Korea Investment Mcp — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Korea Investment Mcp (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
이 프로젝트는 한국투자증권 OpenAPI를 활용하여 주식 및 파생상품 정보를 제공하는 MCP(Model Context Protocol) 서버입니다.
직접 만든 @jissp/nestjs-mcp-server 를 사용하였고, AI 모델이 한국투자증권의 실시간 주가 조회, 순위 분석, 투자자 매매 동향 등의 데이터를 직접 활용할 수 있게 합니다.
npm install프로젝트 루트에 .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_ID# 빌드
npm run build
# 서버 실행
npm run start:prod이 서버는 SSE(Server-Sent Events) 방식을 통해 MCP 프로토콜을 지원합니다. Claude Code(CLI)에서 이 서버를 사용하려면 서버를 먼저 실행한 후 설정을 추가해야 합니다.
터미널 또는 Docker 컨테이너를 시작하여 서버를 실행합니다.
npm run start:prod또는
docker compose up -d서버는 기본적으로 http://localhost:3000에서 동작하며, MCP 엔드포인트는 http://localhost:3000/mcp입니다.
새 터미널 창을 열고 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 모델에게 제공합니다.
inquire-index-price: 국내 업종별 지수의 현재가를 조회합니다.inquire-index-daily-price: 업종별 일자별 시세를 조회합니다.search-stock-info: 주식의 기본 정보를 조회합니다 (상품유형, 종목코드 등).intstock-multi-price: 여러 관심 종목의 현재가를 한 번에 조회합니다.investor-trade-by-stock-daily: 특정 종목의 일별 투자자 매매 추이를 분석합니다.investor-daily-by-market: 시장별(코스피/코스닥 등) 투자자 매매 동향을 조회합니다.hts-top-view: HTS 화면별 인기 조회 종목 순위를 제공합니다.volume-rank: 거래량 기준 종목 순위를 조회합니다.fluctuation-rank: 등락률 기준 종목 순위를 조회합니다.credit-balance-rank: 신용융자 잔고 상위 종목을 조회합니다.short-sale-rank: 공매도 잔고 상위 종목을 조회합니다.daily-credit-balance: 일별 신용융자 잔고 추이를 조회합니다.daily-short-sale: 일별 공매도 거래 현황을 조회합니다.daily-loan-trans: 일별 대차거래 현황을 조회합니다.future-option-price: 선물/옵션 현재가 시세를 조회합니다.future-option-period-price: 선물/옵션의 기간별 시세를 조회합니다.~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.