J-Quants Timeseries MCP

J-Quants API V2에서 일본 주식의 일봉을 가져와 ChatGPT가 Google Drive의 「時系列データ」 폴더에 저장할 수 있는 CSV를 반환하는 개인용 MCP 서버입니다.

주요 동작

• 종목 코드 또는 회사명으로 상장 종목 검색

• /v2/equities/bars/daily의 전체 페이지 가져오기

• 조정 전·조정 후 OHLCV와 상한가·하한가 플래그를 CSV로 변환

• Render의 비밀 설정에서 저장 대상 폴더 ID를 읽어와 도구 결과에 포함

• 종목이 모호할 때는 후보를 반환하고 추측으로 선택하지 않음

Related MCP server: Enhanced MCP Stock Query System

환경 변수

API 키, Drive 폴더 ID, 액세스 토큰은 소스, 대화, 로그에 기록하지 마세요.

로컬 테스트

python -m venv .venv
.venv/bin/pip install -r requirements.txt
PYTHONPATH=. .venv/bin/python -m unittest discover -s tests -v

Windows PowerShell에서는 가상 환경의 Python을 .venv\\Scripts\\python.exe로 바꿔 읽어 주세요.

시작

JQUANTS_API_KEY=... GOOGLE_DRIVE_FOLDER_ID=... MCP_ACCESS_TOKEN=32文字以上の秘密文字列 python server.py

연결 URL은 다음 형식입니다.

https://<Renderのホスト名>/mcp/<MCP_ACCESS_TOKEN>

이 URL 전체를 비밀 정보로 취급하세요. 개인 이용을 위한 간이적인 보호이며, OAuth 인증을 대체할 강력한 방식은 아닙니다. 유출된 경우 MCP_ACCESS_TOKEN을 다시 생성하세요.

ChatGPT 쪽

1. 웹 버전 ChatGPT의 '설정' → '보안 및 로그인'에서 Developer mode를 활성화합니다.

2. Plugins 추가 화면에서 위 MCP URL을 등록합니다.

3. 대화에서 Developer mode에서 J-Quants 앱과 Google Drive를 선택합니다.

4. 'キオクシアの時系列データを取って'라고 요청합니다.

도구는 CSV 본문, 파일 이름, 비밀 설정에서 읽어온 저장 대상 폴더 ID를 반환합니다. ChatGPT는 해당 CSV를 지정된 Google Drive 폴더에 업로드합니다.

J-Quants Free 제한

Free 플랜에서는 가져올 수 있는 주가는 최근 12주를 제외한 과거 2년치입니다. 실제로 반환된 first_date와 last_date를 확인하세요.