KIS MCP Server

韩国投资证券REST API MCP服务，提供国内外股票交易、实时行情查询、账户管理等功能，支持异步处理和稳定错误处理。

金融开发者工具 #股票交易 #实时行情 #账户管理 #异步处理 .Python

评分 : 2.5分

下载量 : 17

更新时间 : 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`	下达国际卖出委托指令