DB증권 Open API를 내 PC 안에서만 동작하는 안전한 브로커로 노출하는 로컬 MCP 앱.
Claude · Gemini · OpenAI에서 한국 주식 시세·차트·계좌·주문을 자연어로 다룹니다.
AI 클라이언트는 내 PC의 로컬 주소에만 접속하고, 앱이 대신 DB증권 API를 호출합니다.
아래 “다운로드”에서 OS에 맞는 설치 파일을 받아 1회 실행. 설치 후 앱이 트레이(작업표시줄)에 상주합니다.
트레이 아이콘 → 설정 열기에서 DB증권 앱키 / 시크릿키를 입력. 키는 OS 보안저장소에만 저장됩니다.
저장하면 MCP 서버가 시작되고 Claude Desktop · Gemini CLI 설정에 자동 등록됩니다(로컬 토큰 포함).
“삼성전자 현재가 알려줘”처럼 말하면 AI가 도구를 호출해 실시간 데이터를 가져옵니다.
DBOpenAPIMCP_cli_x64.exe 더블클릭dbsec 도구가 보입니다.Claude Desktop · Gemini CLI는 설정 단계에서 자동 등록(아래 stdio 형식)됩니다. OpenAI는 코드 방식이라 --http 모드를 씁니다.
자동 등록됨 · 수동 시 claude_desktop_config.json (Win: %APPDATA%\Claude\)
{
"mcpServers": {
"dbsec": {
"command": "C:\\...\\DBOpenAPIMCP_cli_x64.exe",
"args": ["--stdio"]
}
}
}
자동 등록됨 · 수동 시 ~/.gemini/settings.json (Claude와 동일 stdio 형식)
{
"mcpServers": {
"dbsec": {
"command": "C:\\...\\DBOpenAPIMCP_cli_x64.exe",
"args": ["--stdio"]
}
}
}
OpenAI는 코드 방식 → 먼저 DBOpenAPIMCP_cli_x64.exe --http 실행(콘솔에 PORT·TOKEN 표시) 후 그 값으로:
from agents.mcp import MCPServerStreamableHttp
dbsec = MCPServerStreamableHttp(
params={"url": "http://127.0.0.1:PORT/mcp",
"headers": {"Authorization": "Bearer TOKEN"}}
)
127.0.0.1에 도달할 수 없어 로컬 클라이언트에서만 사용합니다.| 도구 | 설명 | 예시 말 |
|---|---|---|
search_symbols | 종목명/키워드 검색 | “삼성 들어간 종목 찾아줘” |
get_quote | 현재가·등락·거래량 | “삼성전자 현재가” |
get_multi_quote | 여러 종목(≤50) 현재가 | “삼성·하이닉스·카카오 시세” |
get_orderbook | 호가(매수/매도 잔량) | “005930 호가 보여줘” |
get_chart | 틱/분/일/주/월 차트 | “최근 60일 일봉” |
get_balance / get_deposit | 잔고 · 예수금(계좌번호) | “내 계좌 잔고” |
place_order 외 | 주문/정정/취소 ⚠️ 기본 비활성·dry-run | “(주의) 매수 주문” |
DBSEC_ENABLE_TRADING=false) dry_run 시뮬레이션 가드. 실거래 검증은 모의투자로.