MCP 주식 시장

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

요구 사항

• Node.js v18 이상

• Alpha Vantage API 키(무료 계층 사용 가능)

Related MCP server: Stock Ticker MCP Server

설정

1. 종속성 설치

   지엑스피1

2. .env.example 기반으로 .env 파일을 만들고 Alpha Vantage API 키를 추가합니다.

   ALPHA_VANTAGE_API_KEY=your_api_key_here

   Alpha Vantage 에서 무료 API 키를 얻을 수 있습니다.

3. 프로젝트를 빌드하세요

   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 호출

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

문제 해결

문제가 발생하는 경우:

1. .env 파일에 Alpha Vantage API 키가 올바르게 설정되었는지 확인하세요.

2. Node.js 버전 18 이상을 사용하고 있는지 확인하세요.

3. MCP 클라이언트 구성의 경로가 올바른지 확인하세요.

4. MCP 클라이언트를 다시 시작하세요