Alpha Vantage API용 MCP 서버(@missionsquad/avantage)

이 프로젝트는 @missionsquad/avantage 라이브러리를 래핑하는 모델 컨텍스트 프로토콜(MCP) 서버를 제공하여 Alpha Vantage API 기능을 언어 학습 모델(LLM) 도구로 제공합니다.

개요

이 서버를 통해 LLM은 Alpha Vantage API와 상호 작용하여 다음을 포함한 재무 데이터를 검색할 수 있습니다.

• 핵심 주식 데이터(시계열, 시세, 검색)

• 기본 데이터(회사 개요, 재무, 일정)

• 외환(FX) 데이터

• 암호화폐 데이터

• 상품 데이터

• 경제 지표

• 기술 지표

• 알파 인텔리전스(뉴스, 감정 등)

• 옵션 데이터(프리미엄)

@missionsquad/avantage TypeScript 라이브러리를 활용하고 일반 MCP 서버 템플릿의 아키텍처를 따르며, 여기에는 다중 사용자 API 키 처리 및 AVantage 클라이언트 인스턴스의 리소스 관리가 포함됩니다.

주요 특징:

• 포괄적인 적용 범위: @missionsquad/avantage 라이브러리에서 사용 가능한 거의 모든 기능에 대한 MCP 도구를 구현합니다.

• 다중 사용자 지원: extraArgs (권장) 또는 환경 변수로의 대체를 통해 Alpha Vantage API 키를 안전하게 처리합니다.

• 리소스 관리: ResourceManager 사용하여 AVantage 클라이언트 인스턴스를 효율적으로 관리합니다.

• 강력한 형식화: TypeScript로 구축되었으며, 도구 매개변수에 @missionsquad/avantage 및 Zod 스키마의 형식을 활용합니다.

• 표준 MCP 인터페이스: MCP 통신을 위해 @missionsquad/fastmcp 사용합니다.

Related MCP server: Zentickr - Yahoo Finance MCP Server

시작하기

필수 조건

• Node.js v20 이상

• npm 또는 yarn

• Alpha Vantage API 키( 여기서 받으세요)

설정

1. 복제 또는 복사: 이 저장소를 복제하거나 파일을 복사합니다.

   지엑스피1

2. 종속성 설치:

   npm install
   # or
   yarn install

3. 환경 구성:

   • .env.example``.env 로 복사합니다.

   • .env 편집하고 API_KEY Alpha Vantage API 키로 설정합니다.

   • 프리미엄 구독이 있는 경우 AV_PREMIUM=true 설정합니다.

   • 필요한 경우 LOG_LEVEL 또는 RESOURCE_CLEANUP_INTERVAL 조정하세요.

4. 프로젝트 빌드:

   npm run build
   # or
   yarn build

5. 서버를 시작합니다:

   npm start
   # or
   yarn start

   서버는 stdio에서 MCP 요청을 수신합니다.

입증

서버는 표준 다중 사용자 토큰 처리 패턴을 사용합니다.

1. extraArgs.apiKey (권장): MCP call_tool 요청 시 extraArgs 객체의 apiKey 필드에 사용자별 Alpha Vantage API 키를 전달합니다. 이 키는 도구 스키마에 포함되지 않습니다 .

2. .env 대체: extraArgs.apiKey 제공되지 않으면 서버는 .env 파일의 API_KEY 값을 사용합니다.

사용 가능한 도구

이 서버는 @missionsquad/avantage 라이브러리의 메서드에 해당하는 다양한 도구를 제공합니다. 도구의 이름은 일반적으로 module_method 입니다(예: coreStock_intraday , fundamentalData_companyOverview ).

매개변수와 반환 구조에 대한 자세한 내용은 Alpha Vantage 설명서 와 @missionsquad/avantage 라이브러리의 유형(라이브러리 내의 src/types/* )을 참조하세요.

예시 도구 호출(개념적 MCP 요청):

{
  "type": "call_tool",
  "requestId": "req-123",
  "tool": {
    "name": "coreStock_quote",
    "arguments": {
      "symbol": "IBM"
    }
  },
  "context": {
    "extraArgs": {
      "apiKey": "USER_SPECIFIC_AV_KEY" // Optional: User's key
    }
  }
}

도구 카테고리(모듈):

• alphaIntelligence_*

• commodities_*

• coreStock_*

• crypto_*

• economicIndicators_*

• forex_*

• fundamentalData_*

• optionsData_* (프리미엄)

• technicalIndicators_*

MCP list_tools 명령을 사용하면 사용 가능한 도구의 전체 목록, 설명 및 매개변수 스키마를 얻을 수 있습니다.

구성

.env 파일을 통해 구성:

프로젝트 구조

일반적인 MCP 서버 템플릿 구조를 따릅니다. 주요 파일:

• src/index.ts : 메인 서버 진입점, 도구 정의.

• src/config.ts : 구성 로딩.

• src/logger.ts : 로깅 유틸리티.

• src/resource-manager.ts : AVantage 인스턴스를 관리합니다.

• src/schemas.ts : 도구 매개변수에 대한 Zod 스키마.

• .nexus/ : Nexus 문서.

넥서스 문서

• .nexus/features/avantage_integration/feature.md

• .nexus/architecture/server_structure.md

• .nexus/guides/using_avantage_tools.md

• .nexus/decisions/decision_log.md

특허

MIT(템플릿 라이선스가 MIT라고 가정. 확인하세요.)