@qubaomingg/stock-mcp

알파 밴티지 스톡 MCP 서버

Alpha Vantage API에서 주식 시장 데이터를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. Claude를 비롯한 MCP 클라이언트는 이를 통해 실시간 및 과거 주식 데이터에 접근할 수 있습니다.

특징

• 사용자 정의 가능한 간격으로 일중 주식 데이터를 얻으세요
• 매일 주식 데이터를 받으세요
• 가격 변동에 따라 주식 알림 생성
• 주식 데이터를 리소스로 접근하세요

필수 조건

• Node.js 16 이상
• Alpha Vantage API 키( Alpha Vantage 에서 무료로 받으세요)

설치

1. 이 저장소를 복제하세요
2. 종속성 설치:지엑스피1
3. 루트 디렉토리에 .env 파일을 만들고 Alpha Vantage API 키를 추가하세요.
   ALPHA_VANTAGE_API_KEY=your_api_key_here

건물과 운영

TypeScript 코드를 작성합니다.

서버를 실행합니다:

자동 재로딩을 이용한 개발의 경우:

API 클라이언트 테스트:

Claude와 함께 데스크톱 사용

Claude for Desktop과 함께 이 MCP 서버를 사용하려면:

1. 데스크톱용 Open Claude
2. 설정 > 개발자 > 구성 편집으로 이동하세요.
3. claude_desktop_config.json 에 다음을 추가하세요.

/absolute/path/to/dist/index.js 빌드된 index.js 파일의 절대 경로로 바꿉니다.

4. 데스크톱용 Claude 재시작

사용 가능한 도구

주식 데이터 가져오기

특정 종목에 대한 일중 주식 데이터를 가져옵니다.

매개변수:

• symbol (필수): 주식 기호(예: IBM, AAPL)
• interval (선택 사항): 데이터 포인트 간 시간 간격(1분, 5분, 15분, 30분, 60분). 기본값: 5분
• outputsize (선택 사항): 반환할 데이터 양(compact: 최근 100개 데이터 포인트, full: 최대 20년 분의 데이터). 기본값: compact

매일 주식 데이터 가져오기

특정 종목에 대한 일일 주가 데이터를 가져옵니다.

매개변수:

• symbol (필수): 주식 기호(예: IBM, AAPL)
• outputsize (선택 사항): 반환할 데이터 양(compact: 최근 100개 데이터 포인트, full: 최대 20년 분의 데이터). 기본값: compact

주식 알림 받기

가격 변동에 따라 알림을 생성하기 위해 주식 데이터를 분석합니다.

매개변수:

• symbol (필수): 주식 기호(예: IBM, AAPL)
• threshold (선택 사항): 가격 변동 알림에 대한 백분율 임계값입니다. 기본값: 5

사용 가능한 리소스

주식 데이터

주식 데이터를 리소스로 직접 접근하세요.

URI 템플릿: stock://{symbol}/{interval}

매개변수:

• symbol : 주식 기호(예: IBM, AAPL)
• interval : 시간 간격(매일, 1분, 5분, 15분, 30분, 60분). 기본값: 매일

Claude에서의 사용 예:

• "stock://AAPL/daily의 주식 데이터를 분석해 주실 수 있나요?"
• "이 데이터에 대해 어떻게 생각하십니까: stock://MSFT/5min"

특허

아이에스씨