🇰🇷 한국어 | 🇺🇸 영어

🚀 Korea Stock MCP가 오픈소스 MCP에서 한 단계 더 나아갑니다. 정확한 한국 주식 데이터를 바탕으로, AI가 더 믿을 수 있는 답변을 제공하도록 돕는 새로운 서비스를 준비하고 있습니다. 새로운 서비스의 방향을 확인해보세요.

한국 주식 분석을 위한 MCP 서버입니다.
DART(전자공시시스템)와 KRX(한국거래소) 공식 API를 통해 주가 정보와 공시 자료 기반의 AI분석이 가능합니다.

💬 개선 요청 & 피드백 환영합니다! 사용하면서 불편한 점이나 개선 아이디어가 있으시면 편하게 이메일 주세요. 빠르게 확인하고 반영하겠습니다. 📧 [email protected]

🎯 주요 기능

• 🔍 공시검색 - 회사별, 기간별 공시 검색
• 📊 공시 데이터 - 공시보고서 원본파일 파싱한 데이터 제공
• 💼 재무제표 분석 - XBRL 기반 상세 재무 데이터
• 📈 주식 데이터 - KRX(코스피/코스닥) 일별 주가정보, 종목 기본정보

⚡ 빠른 시작

1️# ^ API KEY 발급

먼저 DART와 KRX의 API KEY를 발급받아야 합니다.

📝 다트 API 키 발급

1. 회원가입: OPEN DART 회원가입
2. 키 신청: 인증키 신청 페이지에서 API KEY 신청
3. 키 확인: 오픈API 이용현황에서 발급된 API KEY 확인

📈 KRX API KEY 발급

1. 회원가입: KRX OPEN API에서 회원가입 및 로그인
2. 키 신청: 마이페이지 → API 인증키 신청에서 신청
3. 서비스 신청: 승인 후 서비스이용 → 주식 메뉴로 이동
4. API 이용신청: 다음 6개 항목에서 각각 “API 이용신청” 클릭

• 유가증권 일별매매정보
• 코스닥 일별매매정보
• 코넥스 일별매매정보
• 유가증권 종목기본정보
• 코스닥 종목기본정보
• 코넥스 종목기본정보

⏱️ 승인까지 약 1일 소요됩니다.

5. 키 확인: 승인 후 마이페이지 → API 인증키 발급내역에서 API KEY 확인

2️# Claude Desktop 설정

1. Claude Desktop 실행
2. 설정 → 개발자 → 구성편집 클릭

Korea Stock MCP Server

🇰🇷 한국어 | 🇺🇸 English

🚀 Korea Stock MCP가 오픈소스 MCP에서 한 단계 더 나아갑니다. 정확한 한국 주식 데이터를 바탕으로, AI가 더 믿을 수 있는 답변을 제공하도록 돕는 새로운 서비스를 준비하고 있습니다. 새로운 서비스의 방향을 확인해보세요.

한국 주식 분석을 위한 MCP 서버입니다.
DART(전자공시시스템)와 KRX(한국거래소) 공식 API를 통해 주가 정보와 공시 자료 기반의 AI분석이 가능합니다.

💬 개선 요청 & 피드백 환영합니다! 사용하면서 불편한 점이나 개선 아이디어가 있으시면 편하게 이메일 주세요. 빠르게 확인하고 반영하겠습니다. 📧 [email protected]

🎯 주요 기능

• 🔍 공시검색 - 회사별, 기간별 공시 검색
• 📊 공시 데이터 - 공시보고서 원본파일 파싱한 데이터 제공
• 💼 재무제표 분석 - XBRL 기반 상세 재무 데이터
• 📈 주식 데이터 - KRX(코스피/코스닥) 일별 주가정보, 종목 기본정보

⚡ 빠른 시작

1️⃣ API KEY 발급

먼저 DART와 KRX의 API KEY를 발급받아야 합니다.

📝 DART API KEY 발급

1. 회원가입: OPEN DART 회원가입
2. 키 신청: 인증키 신청 페이지에서 API KEY 신청
3. 키 확인: 오픈API 이용현황에서 발급된 API KEY 확인

📈 KRX API KEY 발급

1. 회원가입: KRX OPEN API에서 회원가입 및 로그인

2. 키 신청: 마이페이지 → API 인증키 신청에서 신청

3. 서비스 신청: 승인 후 서비스이용 → 주식 메뉴로 이동

4. API 이용신청: 다음 6개 항목에서 각각 “API 이용신청” 클릭

   • 유가증권 일별매매정보
   • 코스닥 일별매매정보
   • 코넥스 일별매매정보
   • 유가증권 종목기본정보
   • 코스닥 종목기본정보
   • 코넥스 종목기본정보

   ⏱️ 승인까지 약 1일 소요됩니다.

5. 키 확인: 승인 후 마이페이지 → API 인증키 발급내역에서 API KEY 확인

2️⃣ Claude Desktop 설정

1. Claude Desktop 실행
2. 설정 → 개발자 → 구성편집 클릭
3. claude_desktop_config.json 파일에 다음 내용 추가:

{
  "mcpServers": {
    "korea-stock-mcp": {
      "command": "npx",
      "args": ["-y", "korea-stock-mcp@latest"],
      "env": {
        "DART_API_KEY": "",
        "KRX_API_KEY": ""
      }
    }
  }
}

4. 재시작: Claude Desktop을 재시작하여 설정 적용

이제 Claude에서 한국 주식 데이터 분석을 시작할 수 있습니다.

대용량 공시 문서 처리

일부 공시보고서(사업보고서, 분기보고서 등)는 수 MB에 달하는 대용량 XML 문서입니다. 이런 문서를 한 번에 모두 처리하면 AI 응답 한도를 초과하거나 오류가 발생할 수 있습니다.

어떻게 동작하나요?

문서 크기에 따라 자동으로 처리 방식이 달라집니다.

• 소용량 문서 (1MB 미만): 문서 전체를 바로 반환합니다.
• 대용량 문서 (1MB 이상): 문서 전체 대신 **목차(TOC)**를 먼저 반환합니다. Claude가 목차를 보고 질문과 관련된 섹션을 자동으로 선택해 내용을 가져옵니다.

유저 안내

별도로 조작할 필요가 없습니다. Claude가 대용량 문서를 자동으로 처리합니다.

문서가 크면 Claude가 자동으로 다음과 같이 동작합니다:

1. 문서 목차를 확인합니다.
2. 질문과 관련된 섹션을 자동으로 선택해 내용을 조회합니다.
3. 답변 후 나머지 섹션 목록을 안내하므로, 추가로 궁금한 섹션이 있으면 요청할 수 있습니다.

예시:

• “사업보고서에서 매출 현황 알려줘” → Claude가 매출 관련 섹션을 자동 선택
• “방금 목차에서 3번 섹션도 조회해줘” → 특정 섹션 직접 요청 가능

💡 복잡한 질문은 단계별로 나눠서 질문하세요

한 번에 원하는 답을 얻지 못할 때는, 질문을 여러 단계로 나누면 더 정확한 결과를 얻을 수 있습니다.

예를 들어, "인벤테라의 증권신고서에서 외국인 배정 내역 알려줘"가 한 번에 안 된다면:

1. “인벤테라의 고유번호(corp_code) 알려줘”
2. “그 회사의 증권발행 관련 공시 목록 보여줘”
3. “해당 공시 본문을 가져와줘”
4. “외국인 배정 내역을 찾아줘”

이렇게 단계별로 진행하면 각 단계의 결과를 확인하면서 원하는 정보에 도달할 수 있습니다.

---

사용 가능한 도구

DART (전자공시시스템)

1. get_disclosure_list - 공시검색

   • 공시 유형별, 회사별, 날짜별 공시보고서 검색

2. get_corp_code - 고유번호 조회

   • DART 등록 공시대상회사의 고유번호, 회사명, 종목코드 제공