한국투자증권 MCP 서버 클로드, Cursor, Antigravity 연결 방법

한국투자증권 MCP 서버 연결 방법 2가지

안녕하세요! 오늘은 한국투자증권의 방대한 API 명세를 AI 도구에서 바로 활용할 수 있게 해주는 KIS Code Assistant MCP 서버 연결 방법을 정리해 보았습니다. 환경에 따라 가장 적합한 방식을 선택해 보세요.

방법 1: Smithery를 통한 자동 연결

가장 간편한 방법으로, Smithery 커맨드를 사용하여 설정을 자동으로 완료합니다.

지원 가능 제품

claude-code, vscode, cursor, claude, windsurf, cline 등 다양한 IDE와 클라이언트를 지원합니다.

연결 명령 실행

터미널에 아래 명령어를 복사하여 붙여넣기만 하면 자동으로 등록됩니다.

npx -y @smithery/cli@latest install KISOpenAPI/kis-code-assistant-mcp --client antigravity

방법 2: 로컬 설치 (Antigravity 사용자 필수)

외부 서버 상태에 구애받지 않고 가장 안정적으로 사용할 수 있는 '내 컴퓨터 직접 설치' 방식입니다. uv라는 도구를 활용합니다.

• 1단계: uv 설치 - PowerShell에서 powershell -c "irm https://astral.sh/uv/install.ps1 | iex"를 입력하여 설치합니다.
• 2단계: 저장소 클론 - 작업 폴더로 이동 후 git clone https://github.com/koreainvestment/open-trading-api.git를 실행합니다.
• 3단계: 의존성 설치 - MCP/KIS Code Assistant MCP 폴더로 이동하여 uv sync 명령어를 입력합니다.
• 4단계: 경로 확인 - uv.exe의 절대 경로와 프로젝트 폴더의 경로를 메모해 둡니다.

Antigravity 설정 파일 수정

mcp_config.json 파일을 열고 아래 형식을 참고하여 경로를 수정하세요.

{ "mcpServers": { "kis-code-assistant-local": { "command": "C:\\Users\\사용자이름\\.cargo\\bin\\uv.exe", "args": [ "--directory", "C:\\workspace\\stock\\open-trading-api\\MCP\\KIS Code Assistant MCP", "run", "server.py", "--stdio" ] } } }

왜 로컬 방식이 더 유리할까요?

비교 항목	기존 방식 (Remote)	로컬 방식 (Local)
연결 프로토콜	http (외부 의존)	stdio (내 PC 실행)
안정성	서버 점검 시 중단	언제나 사용 가능
실행 주체	브라우저 기반	uv 가상환경 기반

최종 확인 체크리스트

• uv sync가 Done 메시지와 함께 성공적으로 끝났나요?
• 설정 변경 후 Antigravity를 재시작 하셨나요?
• Manage MCP Servers 메뉴에서 초록색 불이 들어왔나요?

이제 채팅창에 "국내 주식 현재가 조회를 위한 파라미터 알려줘"라고 질문해 보세요. 한국투자증권의 코딩 도우미가 바로 답변을 드릴 것입니다! 🚀