KIS MCP Server

韓國投資證券REST API MCP服務，提供國內外股票交易、即時行情查詢、賬戶管理等功能，支持異步處理和穩定錯誤處理。

金融開發者工具 #股票交易 #即時行情 #賬戶管理 #異步處理 .Python

評分 : 2.5分

下載量 : 26

更新時間 : 2025-04-29

한국투자증권 MCP 서버란?

이 서버는 한국투자증권의 API를 통해 주식 시세 조회, 매매 주문, 계좌 관리 등 다양한 금융 서비스를 제공합니다. 비동기 방식으로 빠른 처리가 가능하며, 국내외 주식 시장을 모두 지원합니다.

MCP 서버 사용 방법

Python 환경에서 간단한 설치 후 API 키를 설정하면 바로 사용할 수 있습니다. 주식 조회, 주문, 잔고 확인 등 기본 기능을 쉽게 실행할 수 있습니다.

적용 시나리오

개인 투자 자동화, 주식 데이터 분석, 알고리즘 트레이딩 시스템 구축 등에 적합합니다. 모의 투자 계좌로 테스트 후 실제 투자에 적용할 수 있습니다.

주요 기능

국내 주식 거래국내 주식의 실시간 시세 조회, 매수/매도 주문, 잔고 확인 등 기본적인 거래 기능을 제공합니다.

해외 주식 거래미국, 일본, 중국 등 주요 해외 시장의 주식 거래를 지원합니다. 다양한 통화와 시장 규칙을 고려한 거래가 가능합니다.

비동기 처리비동기 방식으로 API 요청을 처리하여 빠른 응답 속도를 보장합니다. 여러 요청을 동시에 처리할 수 있습니다.

실시간 데이터주식 시세, 호가, 체결 정보 등을 실시간으로 제공합니다. 최신 시장 정보를 빠르게 확인할 수 있습니다.

장점과 제한사항

장점

한국투자증권의 공식 API를 사용하여 안정적인 서비스 제공

국내외 다양한 주식 시장 지원

비동기 처리로 빠른 응답 속도

확장 가능한 구조로 커스터마이징 용이

제한사항

한국투자증권 계좌가 필요하며, API 사용 승인 절차가 필요할 수 있음

API 호출 횟수 제한이 있어 대량의 요청에는 적합하지 않음

해외 주식 거래 시 추가 수수료가 발생할 수 있음

실제 투자 전 모의 투자 계좌로 충분한 테스트 필요

사용 방법

환경 설정

Python 3.13 이상이 설치되어 있어야 합니다. 가상 환경을 생성하고 활성화합니다.

의존성 설치

필요한 패키지를 설치합니다.

API 키 설정

한국투자증권에서 발급받은 앱 키와 시크릿 키를 환경 변수로 설정합니다.

계좌 정보 설정

사용할 계좌 번호와 계좌 타입(실거래/모의투자)을 설정합니다.

기능 사용

설치가 완료되면 Python 스크립트나 인터프리터에서 API 기능을 호출할 수 있습니다.

사용 예시

국내 주식 매수삼성전자 주식을 시장가로 매수하는 예시입니다.

해외 주식 시세 조회애플(AAPL) 주식의 현재가를 나스닥 시장에서 조회하는 예시입니다.

계좌 잔고 확인현재 계좌의 보유 종목과 평가 금액을 확인하는 예시입니다.

자주 묻는 질문

모의 투자 계좌와 실거래 계좌의 차이는 무엇인가요?

API 호출 제한이 있나요?

해외 주식 거래 시 주의할 점은 무엇인가요?

실시간 데이터를 구독하려면 어떻게 해야 하나요?

추가 자료

한국투자증권 개발자 센터

한국투자증권의 공식 API 문서와 가이드

GitHub 저장소

이 프로젝트의 소스 코드와 이슈 트래커

Python 공식 문서

Python 프로그래밍 언어 공식 문서

비동기 Python 가이드

Python 비동기 프로그래밍 학습 자료

🚀 韓國投資證券 REST API MCP（模型上下文協議）

通過韓國投資證券(KIS)的REST API，藉助MCP（模型上下文協議）服務器，可實現股票交易以及市場行情信息的查詢。該系統支持國內及海外股票交易、賬戶管理等多樣化金融服務，為用戶提供便捷、高效的金融交易體驗。

🚀 快速開始

本項目可通過韓國投資證券的REST API，利用MCP服務器開展股票交易和市場行情信息查詢等操作。使用前，需按以下步驟配置相關信息。

✨ 主要特性

🇰🇷 國內股票交易
- 即時當前價查詢
- 買入/賣出訂單
- 資金餘額查詢
- 報價信息查詢
- 訂單記錄查詢
🌍 海外股票交易
- 查詢海外市場即時行情（包括美國、日本、中國、香港、越南等）
- 根據市場代碼和股票代碼進行價格查詢
- 下達買入或賣出指令

⚠️ 重要提示

請勿隨意洩露API密鑰，確保賬戶安全。使用前需仔細閱讀相關協議。

📦 安裝指南

通過環境變量配置API密鑰和賬戶信息：

KIS_APP_KEY：韓國投資證券應用編程接口密鑰
KIS_APP_SECRET：韓國投資證券應用程序加密密鑰
KIS_ACCOUNT_TYPE：賬戶類型（"REAL" 或 "VIRTUAL"）
KIS_CANO：客戶賬號

💻 使用示例

國內股票交易功能

函數名稱	描述
`inquiry_domestic_stock_price`	查詢國內股票即時行情
`order_purchase`	下達買入委託指令
`order_sale`	下達賣出委託指令
`inquiry_balance`	查詢賬戶資金餘額
`inquiry_order`	查詢當前訂單狀態

海外股票交易功能

函數名稱	描述
`inquiry_overseas_stock_price`	根據市場代碼查詢海外股票價格
`order_purchase_international`	下達國際買入委託指令
`order_sale_international`	下達國際賣出委託指令