SSI Stock Data MCP Server

목차

• 목차
• 1. 서론
• 2. 특징
• 3. 빠른 시작
  • 3.1. 전제 조건
  • 3.2. 로컬 실행
  • 3.3. 도커 런
• 4. 도구
• 5. 개발
• 6. 라이센스

1. 서론

SSI Stock Data MCP는 베트남 주식 일중 데이터를 수집하는 모델 컨텍스트 프로토콜 (MCP) 서버입니다. AI 지원 도구와 툴이 SSI FastConnect API를 사용하여 일중 데이터를 프로그래밍 방식으로 안전하게 쿼리할 수 있도록 지원합니다.

2. 특징

• [x] 거래소별 주식코드 목록
• [x] 주식코드의 상세정보를 검색합니다.
• [x] 인덱스 바구니에 있는 주식 코드 목록을 검색합니다.
• [x] 인덱스 코드 목록을 검색합니다.
• [x] 각 틱 데이터별로 주식코드의 시가, 고가, 저가, 종가, 거래량, 가치 정보를 검색합니다.
• [x] 일별 주식코드의 시가, 고가, 저가, 종가, 거래량, 가치 정보를 검색합니다.
• [x] 종합지수의 일일 거래 결과를 검색합니다.
• [x] 주식코드의 일일 거래정보 검색
• [x] Docker 컨테이너화 지원
• [ ] 스트리밍 어댑터를 통해 실시간 데이터 지원(계획)
• [ ] MCP를 통한 주문 관리 및 거래 지원 (향후 고려)

3. 빠른 시작

3.1. 전제 조건

• 파이썬 3.12+
• uv (빠른 종속성 관리를 위해).
• Docker(컨테이너화된 배포의 경우 선택 사항).
• 이 MCP 서버를 실행하기 전에 SSI FastConnect 서비스에 등록하세요. SSI FastConnect 에 등록하면 소비자 ID와 비밀번호를 받으실 수 있습니다.

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 SSI Stock MCP 서버를 자동으로 설치하려면:

지엑스피1

3.2. 로컬 실행

• 저장소를 복제합니다.

• 환경 변수 구성

• 클라이언트 설정 파일에 서버 설정을 추가하세요. 예를 들어, Claude Desktop의 경우:

• 새로운 구성을 로드하려면 Claude Desktop을 다시 시작하세요.
• 이제 Claude에게 자연어를 사용하여 데이터와 상호 작용하도록 요청할 수 있습니다.
  • "chỉ số VN30 hôm nay có gì hot không"
  • "볼륨 룸 가져오기 ngoại đã bán của SSI hôm nay"
  • "so sánh vol của SSI với VND trong ngày hôm nay"
  • "총 매치볼 수는 SSI 1개에 달합니다."

3.3. 도커 런

• 미리 빌드된 이미지로 실행하세요(또는 직접 빌드할 수도 있습니다):

• Claude Desktop에서 Docker로 실행:

이 구성은 -e 플래그와 변수 이름만 사용하여 Claude Desktop에서 Docker 컨테이너로 환경 변수를 전달하고, env 객체에 실제 값을 제공합니다.

4. 도구

MCP 서버는 다음과 같은 도구를 제공합니다.

• 증권 목록 가져오기: get_securities_list()
• 증권 세부 정보 가져오기: get_securities_details()
• 인덱스 가져오기: get_index_components()
• 목록 인덱스 가져오기: get_index_list()
• 매일 시가, 고가, 저가, 종가를 구하세요: get_daily_ohlc()
• 일중 시작가, 고가, 저가, 종가를 구하세요: get_intraday_ohlc()
• 일일 인덱스 가져오기: get_daily_index()
• 주가를 구하세요: get_stock_price()

전체 API 세부 정보는 src/ssi_stock_mcp_server/server.py를 참조하세요.

5. 개발

기여를 환영합니다! 제안이나 개선 사항이 있으시면 이슈를 개설하거나 풀 리퀘스트를 제출해 주세요.

이 프로젝트에서는 uv를 사용하여 종속성을 관리합니다. 플랫폼별 지침에 따라 uv를 설치하세요.

6. 라이센스

아파치 2.0

연락처 / 지원

• 문제가 발생하거나 지원이 필요하면 GitHub에서 이슈를 열어주세요.
• 이메일: 없음