{"_id":"@drfirst/korea-stock-mcp","_rev":"5-25b1565c1a16b0584d9b43325cfb29e8","name":"@drfirst/korea-stock-mcp","dist-tags":{"latest":"1.0.5"},"versions":{"1.0.0":{"name":"@drfirst/korea-stock-mcp","version":"1.0.0","keywords":["mcp","korea","stock","kospi","kosdaq","naver-finance"],"author":{"name":"DrFirst"},"license":"MIT","_id":"@drfirst/korea-stock-mcp@1.0.0","maintainers":[{"name":"drfirst","email":"lsi429@naver.com"}],"bin":{"korea-stock-mcp":"index.js"},"dist":{"shasum":"d0c6a5da0bf3ef4b56dd55eed8760cf35e9df034","tarball":"https://registry.npmjs.org/@drfirst/korea-stock-mcp/-/korea-stock-mcp-1.0.0.tgz","fileCount":3,"integrity":"sha512-02mJynP/Fj0QQgdCJ/w/6MlVjSU47QOx3TfvW4UNsVtIzjl8E3nEuFCQhLRdwabbyP+/UvAWpm1LPrWO4DZNfw==","signatures":[{"sig":"MEQCIGobifPbaqjHLRYPBUMqLRJ4Uh0eiz8jN2yHwvExTU7+AiA8Fngazhp2YAzvXSFJ++OdpsrGsLcFq6osJ8tUTAaukw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":17684},"main":"index.js","type":"module","engines":{"node":">=18.17.0"},"gitHead":"c21bbf62aa0980aab22d9a6db35d73fc7df87ae0","scripts":{"start":"node index.js"},"_npmUser":{"name":"drfirst","email":"lsi429@naver.com"},"overrides":{"undici":"^5.28.4"},"_npmVersion":"9.6.7","description":"한국 주식 시장 데이터 조회 MCP 서버 (완전 Node.js)","directories":{},"_nodeVersion":"18.17.1","dependencies":{"axios":"^1.6.0","cheerio":"1.0.0-rc.12","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/korea-stock-mcp_1.0.0_1762483321919_0.21336273264488947","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@drfirst/korea-stock-mcp","version":"1.0.1","keywords":["mcp","korea","stock","kospi","kosdaq","naver-finance"],"author":{"name":"DrFirst"},"license":"MIT","_id":"@drfirst/korea-stock-mcp@1.0.1","maintainers":[{"name":"drfirst","email":"lsi429@naver.com"}],"bin":{"korea-stock-mcp":"index.js"},"dist":{"shasum":"d5b2d7ae8413e9a330209c15c7a9c55755b250f3","tarball":"https://registry.npmjs.org/@drfirst/korea-stock-mcp/-/korea-stock-mcp-1.0.1.tgz","fileCount":3,"integrity":"sha512-qvUuT0ek74iicAsQ+eb6sHY1VDuBCJptrK44nkhdVPiSVK+afi+uAv6fU8c89+0r38mJeJ+8m+8CRl6w6gsKTw==","signatures":[{"sig":"MEUCIQCtqZ/fhIQxFaGuJA6I9RT6Rh25gCFctutEuPngWQwcXwIgFtJ4n0d8FoZtgB0aEzuMR1z5aY5AcMQTHGgHF43Pwfo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":21327},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"800133cbfeae89ed9e3947682cca4ab85279d932","scripts":{"start":"node index.js"},"_npmUser":{"name":"drfirst","email":"lsi429@naver.com"},"_npmVersion":"10.9.2","description":"한국 주식 시장 데이터 조회 MCP 서버 (완전 Node.js)","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.25.76","axios":"^1.6.0","cheerio":"^1.1.2","iconv-lite":"^0.7.0","follow-redirects":"^1.15.11","@modelcontextprotocol/sdk":"^1.22.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/korea-stock-mcp_1.0.1_1763346516820_0.9468288167922534","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@drfirst/korea-stock-mcp","version":"1.0.2","keywords":["mcp","korea","stock","kospi","kosdaq","naver-finance"],"author":{"name":"DrFirst"},"license":"MIT","_id":"@drfirst/korea-stock-mcp@1.0.2","maintainers":[{"name":"drfirst","email":"lsi429@naver.com"}],"bin":{"korea-stock-mcp":"index.js"},"dist":{"shasum":"8af288fffff8fbe10d392303619da18209cb58bd","tarball":"https://registry.npmjs.org/@drfirst/korea-stock-mcp/-/korea-stock-mcp-1.0.2.tgz","fileCount":3,"integrity":"sha512-bt77jBwAbu35gi7V94xo+aGVPH/Qt5s5dFDfW/4Ok7pAi3vtOpR37UO/T7jGFErUxdFmztuFucazMa+wlE9/Yw==","signatures":[{"sig":"MEUCIQDESgU18GZQcyqixgLhzo6rt7pg3CrrUiQyzckvWf/ZkQIgWIguloDyBxCvaW8ahNaVMGkpLNRKyxTKWrVyEFDFwjc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":23909},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"09ac20b3a553f1f6377c14e665ad1fc32569e706","scripts":{"start":"node index.js"},"_npmUser":{"name":"drfirst","email":"lsi429@naver.com"},"_npmVersion":"10.9.2","description":"한국 주식 시장 데이터 조회 MCP 서버 (완전 Node.js)","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.25.76","axios":"^1.6.0","cheerio":"^1.1.2","iconv-lite":"^0.7.0","follow-redirects":"^1.15.11","@modelcontextprotocol/sdk":"^1.22.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/korea-stock-mcp_1.0.2_1763350079348_0.9234241988131371","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@drfirst/korea-stock-mcp","version":"1.0.3","keywords":["mcp","korea","stock","kospi","kosdaq","naver-finance"],"author":{"name":"DrFirst"},"license":"MIT","_id":"@drfirst/korea-stock-mcp@1.0.3","maintainers":[{"name":"drfirst","email":"lsi429@naver.com"}],"bin":{"korea-stock-mcp":"index.js"},"dist":{"shasum":"9699f379f8621d83450aa2edcc7c90b50db87cfa","tarball":"https://registry.npmjs.org/@drfirst/korea-stock-mcp/-/korea-stock-mcp-1.0.3.tgz","fileCount":3,"integrity":"sha512-gNW87XFAOSVRYwyOHASobT1PqT/MylWqKJ/5sh1AiWRKwva7rtfVjNqlIWYT7hJsdINcPrGTtChSDNsiQyJsDg==","signatures":[{"sig":"MEYCIQC04pA3eOdt29ymSm6DVOABGsjRRbOvGxeBpt6gIEkaggIhAKHwd30SiupmUFTbkzU6t1+7boQ4aGiNGS919XZJPIyH","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24713},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"fd05122caa60479228da2d003076cb359e23d07c","scripts":{"start":"node index.js"},"_npmUser":{"name":"drfirst","email":"lsi429@naver.com"},"_npmVersion":"10.9.2","description":"한국 주식 시장 데이터 조회 MCP 서버 (완전 Node.js)","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.25.76","axios":"^1.6.0","cheerio":"^1.1.2","iconv-lite":"^0.7.0","follow-redirects":"^1.15.11","@modelcontextprotocol/sdk":"^1.22.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/korea-stock-mcp_1.0.3_1763351034679_0.9209226741832799","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@drfirst/korea-stock-mcp","version":"1.0.5","description":"한국 주식 시장 데이터 조회 MCP 서버 (완전 Node.js)","type":"module","main":"index.js","bin":{"korea-stock-mcp":"index.js"},"scripts":{"start":"node index.js"},"keywords":["mcp","korea","stock","kospi","kosdaq","naver-finance"],"author":{"name":"DrFirst"},"license":"MIT","engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.22.0","axios":"^1.6.0","cheerio":"^1.1.2","follow-redirects":"^1.15.11","iconv-lite":"^0.7.0","zod":"^3.25.76"},"_id":"@drfirst/korea-stock-mcp@1.0.5","gitHead":"463455feac89cf27433c3819b228079399f0025e","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-RY40D6wHfmKLwP1KS2fA9jMTJ/mWRlP5KY2D7b1txPWjXT3N+z0B1mX37YSZ/BzE8cy6A5c3fQOcV3KYFJzwQg==","shasum":"2329e7d9bd770a594aac9d7582bfed256f70a447","tarball":"https://registry.npmjs.org/@drfirst/korea-stock-mcp/-/korea-stock-mcp-1.0.5.tgz","fileCount":3,"unpackedSize":24805,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCLKvVqSSB+4dluQFQAhjIpKuyD3fgZLIrsq+wkpj7XIQIgdycSBnAsvA0YOOV8kZlRkGEItfzq9eSikt/OtKEnq1w="}]},"_npmUser":{"name":"drfirst","email":"lsi429@naver.com"},"directories":{},"maintainers":[{"name":"drfirst","email":"lsi429@naver.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/korea-stock-mcp_1.0.5_1780636401311_0.42668816685827493"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-07T02:42:01.855Z","modified":"2026-06-05T05:13:21.557Z","1.0.0":"2025-11-07T02:42:02.128Z","1.0.1":"2025-11-17T02:28:37.007Z","1.0.2":"2025-11-17T03:27:59.556Z","1.0.3":"2025-11-17T03:43:54.869Z","1.0.5":"2026-06-05T05:13:21.453Z"},"author":{"name":"DrFirst"},"license":"MIT","keywords":["mcp","korea","stock","kospi","kosdaq","naver-finance"],"description":"한국 주식 시장 데이터 조회 MCP 서버 (완전 Node.js)","maintainers":[{"name":"drfirst","email":"lsi429@naver.com"}],"readme":"# korea-stock-mcp\r\n\r\n네이버 금융 데이터를 MCP(Model Context Protocol)로 노출하는 Node.js 기반 서버입니다.  \r\nClaude Desktop, Cursor 등 MCP 클라이언트에서 한국 ETF / 테마 / 시가총액 / 배당 / 개별 종목 가격을 직접 조회할 수 있게 해줍니다.\r\n\r\n## 기능(툴) 요약\r\n\r\n1. **get_etfs_by_market_cap**\r\n   - `https://finance.naver.com/sise/etf.naver`\r\n   - 시가총액 순으로 ETF 목록을 가져옵니다.\r\n   - 입력\r\n     - `limit` (number, optional, default 50): 최대 결과 개수\r\n   - 출력\r\n     - `items[]`: `{ name, code, currentPrice, nav, changeRate }`\r\n\r\n2. **get_themes_with_leaders**\r\n   - `https://finance.naver.com/sise/theme.naver`\r\n   - 전일대비 상승이 높은 순으로 테마를 가져오고, 각 테마의 주도주 종목명을 함께 반환합니다.\r\n   - 입력\r\n     - `limit` (number, optional, default 50)\r\n   - 출력\r\n     - `items[]`: `{ themeName, themeId, changeRate, leaders[] }`\r\n\r\n3. **get_market_cap_stocks**\r\n   - `https://finance.naver.com/sise/sise_market_sum.naver`\r\n   - 시가총액 순으로 종목 이름과 현재가 정보를 가져옵니다.\r\n   - 입력\r\n     - `sosok` (number, optional): 0=코스피, 1=코스닥 (기본 0)\r\n     - `page` (number, optional, 기본 1)\r\n     - `limit` (number, optional, 기본 50)\r\n   - 출력\r\n     - `items[]`: `{ name, code, currentPrice }`\r\n\r\n4. **get_dividend_yield_stocks**\r\n   - `https://finance.naver.com/sise/dividend_list.naver`\r\n   - 배당수익률이 높은 순으로 종목 정보를 가져옵니다.\r\n   - 입력\r\n     - `page` (number, optional, 기본 1)\r\n     - `limit` (number, optional, 기본 50)\r\n   - 출력\r\n     - `items[]`: `{ name, code, currentPrice, dividend, dividendYield }`\r\n\r\n5. **search_stock_code**\r\n   - `https://finance.naver.com/search/search.naver?query={종목명}`\r\n   - 종목명으로 검색해서 종목코드를 가져옵니다.\r\n   - 입력\r\n     - `query` (string): 종목명 (예: `\"삼성전자\"`)\r\n   - 출력\r\n     - `result`: `{ name, code }` 또는 `null`\r\n\r\n6. **get_stock_price_by_code**\r\n   - `https://finance.naver.com/item/main.naver?code={종목코드}`\r\n   - 종목코드로 현재가 정보를 가져옵니다.\r\n   - 입력\r\n     - `code` (string): 6자리 종목코드 (예: `\"005930\"`)\r\n   - 출력\r\n     - `{ name, code, currentPrice }`\r\n\r\n> 모든 툴은 `structuredContent` 에 JSON 형태 결과를, `content[0].text` 에 pretty-printed JSON 문자열을 포함해서 반환합니다. MCP 클라이언트는 둘 중 편한 형태를 사용할 수 있습니다.\r\n\r\n---\r\n\r\n## 설치 및 실행\r\n\r\n### 1) 로컬 개발용\r\n\r\n```bash\r\n# 프로젝트 초기화\r\nnpm install\r\n\r\n# MCP 서버 실행 (STDIO)\r\nnode index.js\r\n```\r\n\r\n또는\r\n\r\n\r\n```\r\nnpm start\r\n```\r\n\r\n### 2) npx 로 실행\r\n\r\n패키지를 npm에 배포했다면, 다른 환경에서 다음과 같이 실행할 수 있습니다.\r\n\r\n```\r\nnpx korea-stock-mcp\r\n```\r\n(로컬에서 테스트할 때는 npm link 로 글로벌 링크 후 npx korea-stock-mcp 또는 korea-stock-mcp 로 실행할 수 있습니다.)\r\n\r\n\r\n---\r\n\r\n## Claude Desktop 연동 예시\r\n\r\n- `claude_desktop_config.json` 파일을 수정해줍니다.\r\n\r\n```\r\n{\r\n  \"mcpServers\": {\r\n    \"korea-stock-mcp\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@drfirst/korea-stock-mcp@latest\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n\r\n---\r\n\r\n## 사용 예시\r\n\r\n예시 프롬프트:\r\n\r\n> korea-stock-mcp를 활용해서 오늘의 주요 테마와 해당 테마 종목 조회  \r\n> korea-stock-mcp를 활용해서 오늘 etf 정보 조회  \r\n> korea-stock-mcp를 활용해서 오늘의 시가총액 순으로 주식종목 조회하기  \r\n> korea-stock-mcp를 활용해서 티엘비의 시가 알아봐  ","readmeFilename":"readme.md"}