KIS MCP Server

KIS MCP Server

Enables Claude to trade Korean and overseas stocks, check balances, and search stock information through the Korea Investment & Securities Open API.

Category
Visit Server

README

한국투자증권 KIS MCP Server

한국투자증권 Open API를 Claude에서 직접 사용할 수 있는 MCP 서버입니다.

사전 준비

  1. KIS Developers 에서 앱키/앱시크리트 발급
  2. Node.js 22+ 및 npm 설치

환경변수 설정

# 실전투자 (필수)
export KIS_APP_KEY="your_app_key"
export KIS_APP_SECRET="your_app_secret"
export KIS_ACCOUNT_NO="12345678"     # 계좌번호 앞 8자리
export KIS_ACCOUNT_PROD="01"         # 계좌상품코드 (기본값: 01)

# 모의투자 (선택)
export KIS_PAPER_APP_KEY="your_paper_app_key"
export KIS_PAPER_APP_SECRET="your_paper_app_secret"
export KIS_PAPER_ACCOUNT_NO="12345678"

빌드 및 실행

npm install
npm run build

Claude Code 설정 (.mcp.json)

프로젝트 루트 또는 ~/.claude/ 에 추가:

{
  "mcpServers": {
    "kis": {
      "command": "node",
      "args": ["/path/to/koreainvestment-mcp/dist/index.js"],
      "env": {
        "KIS_APP_KEY": "your_app_key",
        "KIS_APP_SECRET": "your_app_secret",
        "KIS_ACCOUNT_NO": "12345678",
        "KIS_PAPER_APP_KEY": "your_paper_app_key",
        "KIS_PAPER_APP_SECRET": "your_paper_app_secret",
        "KIS_PAPER_ACCOUNT_NO": "12345678"
      }
    }
  }
}

개발 중에는 tsx로 직접 실행 가능:

{
  "mcpServers": {
    "kis": {
      "command": "npx",
      "args": ["tsx", "/path/to/koreainvestment-mcp/src/index.ts"],
      "env": { "...": "..." }
    }
  }
}

제공 도구 (12개)

도구 설명 읽기전용
kis_get_domestic_stock_price 국내주식 현재가 조회 ✅
kis_get_domestic_stock_chart 국내주식 일/주/월별 시세 ✅
kis_get_domestic_balance 국내주식 잔고 조회 ✅
kis_get_account_assets 투자계좌 자산 현황 (실전 전용) ✅
kis_place_domestic_order 국내주식 현금 주문 ❌
kis_revise_or_cancel_domestic_order 국내주식 주문 정정/취소 ❌
kis_get_overseas_stock_price 해외주식 현재가 조회 ✅
kis_get_overseas_stock_chart 해외주식 일/주/월별 시세 ✅
kis_get_overseas_balance 해외주식 잔고 조회 ✅
kis_place_overseas_order 해외주식 주문 ❌
kis_search_stock 종목코드·종목명 검색 ✅
kis_master_status 종목 마스터 DB 현황 ✅

주의사항

  • env="real" 주문 도구는 실제 자금이 사용됩니다. 테스트는 반드시 env="demo"를 사용하세요.
  • 주문 도구의 기본값은 env="demo"(모의투자)로 설정되어 있습니다.
  • 실전투자와 모의투자의 앱키/계좌번호는 별개입니다.
  • 토큰은 프로세스 메모리에 캐시되며 만료 5분 전에 자동 재발급됩니다.
  • 종목 마스터 데이터는 ~/.kis_mcp/master.db에 저장되며 하루 1회 자동 갱신됩니다.

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured