AI 연동 — 이 사이트의 MCP 서버

이 사이트(stock-b.diying.co.kr/ai)는 MCP 서버(mcp/worker.js)를 제공합니다. 새 데이터를 만드는 게 아니라, 로컬에 미러링된 정적 JSON(data/public/*)을 JSON-RPC 2.0으로 감싸 텍스트로 포맷해 돌려주는 얇은 층입니다 — 자세한 설계 근거는 kstock_data/03_MCP_서버_분석.md, 04_복제_가이드.md 문서를 참고하세요.

이 MCP 서버는 이 컴퓨터에서 Flask 개발 서버로 실행 중일 때만 동작합니다. 외부(클라우드 Claude/ChatGPT)에서 연결하려면 Cloudflare Tunnel 등으로 이 주소를 공개 URL에 매핑해야 합니다. 로컬 Claude Code · Cursor 등 로컬에서 도는 MCP 클라이언트는 아래 주소를 바로 등록할 수 있습니다.

MCP 엔드포인트

http://stock-b.diying.co.kr/mcp

등록 방법

Claude Code / Cursor (CLI)

claude mcp add --transport http kstock-data http://stock-b.diying.co.kr/mcp

설정 파일에 직접 추가

{
  "mcpServers": {
    "kstock-data": {
      "type": "http",
      "url": "http://stock-b.diying.co.kr/mcp"
    }
  }
}

인증 없음, 세션 헤더 불필요, 무상태(stateless) — 매 호출이 완전히 독립적입니다.

제공 도구 6개

도구	설명
`get_today`	오늘의 시장 요약 — 지수·등락 폭·주요 공시·성장 랭킹
`search_stock`	종목명·코드 부분일치 검색
`get_stock`	6자리 코드로 종목 상세(시세·실적) 조회
`get_rankings`	성장 TOP8 / 조용한 실적주 (kind: growth\|quiet)
`get_disclosures`	최근 공시 — 접수시각(HH:MM)·장 구분 포함
`get_data_urls`	공개 데이터 URL 카탈로그

원본은 12개 도구(list_stocks·get_earnings·get_history·get_disclosure_impact· get_earnings_calendar 등)를 제공합니다 — 이 미니 서버는 핵심 6개만 재현했습니다. 나머지는 mcp_server.py의 TOOLS 목록에 같은 패턴으로 추가할 수 있습니다.

직접 확인해보기

curl -s -X POST http://stock-b.diying.co.kr/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

도구 호출 예시(오늘의 시장 요약):

curl -s -X POST http://stock-b.diying.co.kr/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_today","arguments":{}}}'

MCP 없이 — URL만 붙여넣기

서버를 등록하지 않아도, 로컬에 미러링된 JSON 주소를 챗봇에 그대로 붙여넣으면 됩니다:

http://stock-b.diying.co.kr/data/public/today.json 을 읽고 오늘 시장을 요약해줘.