MCP 주식 시장

Alpha Vantage API를 사용하여 주식 시장 데이터를 검색하는 모델 컨텍스트 프로토콜(MCP) 도구입니다. 이 도구는 간단한 MCP 인터페이스를 통해 모든 종목의 일일 주식 시장 데이터에 접근할 수 있도록 지원합니다.

요구 사항

Node.js v18 이상
Alpha Vantage API 키(무료 계층 사용 가능)

설정

종속성 설치지엑스피1
.env.example 기반으로 .env 파일을 만들고 Alpha Vantage API 키를 추가합니다.
ALPHA_VANTAGE_API_KEY=your_api_key_here
Alpha Vantage 에서 무료 API 키를 얻을 수 있습니다.
프로젝트를 빌드하세요
npm run build

MCP 클라이언트 구성

MCP 클라이언트에서 이 도구를 사용하려면 MCP 서버 구성을 업데이트해야 합니다. 클라이언트 구성에 다음을 추가하세요.

{
  "mcpServers": {
    "stock-market": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-stock-market/build/index.js"
      ]
    }
  }
}

/ABSOLUTE/PATH/TO/PARENT/FOLDER 이 저장소가 있는 상위 디렉토리의 실제 절대 경로로 바꿔야 합니다.

사용 가능한 도구

주식 데이터 가져오기

특정 주식 기호에 대한 일일 주식 시장 데이터를 검색합니다.

매개변수:

symbol : 주식 기호(예: IBM, AAPL, MSFT, GOOG, AMZN)

MCP 클라이언트에서의 사용 예:

@stock-market get-stock-data symbol=AAPL

응답 예시:

Stock: AAPL
Last Updated: 2025-03-12
Time Zone: US/Eastern

Daily Prices:

Date: 2025-03-12
Open: $178.35
High: $180.13
Low: $177.53
Close: $179.63
Volume: 58,492,206
---

Date: 2025-03-11
Open: $177.99
High: $179.70
Low: $176.86
Close: $178.95
Volume: 62,630,570
---

개발

프로젝트 구조

src/index.ts - MCP 서버 및 도구 구현을 포함하는 기본 애플리케이션 파일
build/ - 컴파일된 JavaScript 출력
.env - 환경 변수(API 키)

명령

npm run build - TypeScript 코드 빌드

API 사용 참고 사항

이 도구는 Alpha Vantage API를 사용하여 주식 시장 데이터를 검색합니다. Alpha Vantage 무료 버전에는 다음과 같은 제한 사항이 있습니다.

하루 25개의 API 호출
분당 5개의 API 호출

더 많은 용량이 필요하다면 프리미엄 플랜으로 업그레이드하는 것을 고려하세요.

문제 해결

문제가 발생하는 경우:

.env 파일에 Alpha Vantage API 키가 올바르게 설정되었는지 확인하세요.
Node.js 버전 18 이상을 사용하고 있는지 확인하세요.
MCP 클라이언트 구성의 경로가 올바른지 확인하세요.
MCP 클라이언트를 다시 시작하세요

MCP Stock Market

Integrations