DBOpenAPIMCP

DB증권 Open API를 내 PC 안에서만 동작하는 안전한 브로커로 노출하는 로컬 MCP 앱.
Claude · Gemini · OpenAI에서 한국 주식 시세·차트·계좌·주문을 자연어로 다룹니다.

🔒 앱키·토큰은 PC 밖으로 나가지 않습니다 · 127.0.0.1 전용

↔ 한눈에

AI 클라이언트는 내 PC의 로컬 주소에만 접속하고, 앱이 대신 DB증권 API를 호출합니다.

Claude / Gemini / OpenAIAI 클라이언트(내 PC)
HTTP (로컬)127.0.0.1 ▶
DBOpenAPIMCP127.0.0.1/mcp · 키 보관
HTTPS▶
DB증권 Open API시세·차트·계좌·주문

1 설치 & 사용 4단계

1

다운로드 & 설치

아래 “다운로드”에서 OS에 맞는 설치 파일을 받아 1회 실행. 설치 후 앱이 트레이(작업표시줄)에 상주합니다.

2

앱키 입력 (최초 1회)

트레이 아이콘 → 설정 열기에서 DB증권 앱키 / 시크릿키를 입력. 키는 OS 보안저장소에만 저장됩니다.

3

AI 클라이언트 자동 등록

저장하면 MCP 서버가 시작되고 Claude Desktop · Gemini CLI 설정에 자동 등록됩니다(로컬 토큰 포함).

4

AI에게 자연어로

“삼성전자 현재가 알려줘”처럼 말하면 AI가 도구를 호출해 실시간 데이터를 가져옵니다.

2단계 화면 예시 — 앱키 입력 & 트레이

DBOpenAPIMCP
DBOpenAPIMCP
키는 OS 보안저장소에만 저장 · 외부 전송 없음
••••••••••••••••
••••••••••••••••
키 저장 + MCP 시작
▾ 트레이 메뉴
🟢 MCP 실행 중 · 127.0.0.1
⚙️ 설정 열기
⏻ 종료

4단계 사용 예시 — AI 대화

Claude / Gemini
나
삼성전자 지금 얼마야?
AI
🔧 get_quote(005930)
삼성전자(005930) 현재가 71,500원 (+500, +0.70%) · 거래량 1,000,000주
나
최근 60일 일봉 차트도 보여줘
AI
🔧 get_chart(005930, day, 60)
60일치 일봉(시·고·저·종·거래량)을 가져왔습니다 …

2 다운로드

버전 정보를 확인하는 중…

3 AI 클라이언트 등록

정식 앱은 Claude·Gemini에 자동 등록합니다. 수동 등록 형식은 아래와 같습니다(PORT·TOKEN은 앱이 표시한 값).

Claude Desktop
Gemini CLI
OpenAI Agents SDK

claude_desktop_config.json (Win: %APPDATA%\Claude\, macOS: ~/Library/Application Support/Claude/)

{
  "mcpServers": {
    "dbsec": {
      "type": "http",
      "url": "http://127.0.0.1:PORT/mcp",
      "headers": { "Authorization": "Bearer TOKEN" }
    }
  }
}

~/.gemini/settings.json — 키 이름이 httpUrl인 점만 다릅니다.

{
  "mcpServers": {
    "dbsec": {
      "type": "http",
      "httpUrl": "http://127.0.0.1:PORT/mcp",
      "headers": { "Authorization": "Bearer TOKEN" }
    }
  }
}

사용자 코드에서 직접 연결합니다.

from agents.mcp import MCPServerStreamableHttp

dbsec = MCPServerStreamableHttp(
    params={"url": "http://127.0.0.1:PORT/mcp",
            "headers": {"Authorization": "Bearer TOKEN"}}
)
☁️ 클라우드 경유(Claude Custom Connector 원격 · ChatGPT 웹)는 127.0.0.1에 도달할 수 없어 로컬 클라이언트에서만 사용합니다.

4 사용 가능한 도구

도구설명예시 말
search_symbols종목명/키워드 검색“삼성 들어간 종목 찾아줘”
get_quote현재가·등락·거래량“삼성전자 현재가”
get_multi_quote여러 종목(≤50) 현재가“삼성·하이닉스·카카오 시세”
get_orderbook호가(매수/매도 잔량)“005930 호가 보여줘”
get_chart틱/분/일/주/월 차트“최근 60일 일봉”
get_balance / get_deposit잔고 · 예수금(계좌번호)“내 계좌 잔고”
place_order 외주문/정정/취소 ⚠️ 기본 비활성·dry-run“(주의) 매수 주문”

🔒 안전 설계