Marketstack MCP Server

마켓스택 MCP 서버

다양한 Marketstack API 엔드포인트를 MCP 도구로 제공하는 모델 컨텍스트 프로토콜(MCP) 서버로, 종가, 일중, 스플릿, 배당금, 티커, 거래소, 통화, 시간대, 채권, ETF 데이터 등 금융 데이터에 대한 액세스를 제공합니다. 이 서버를 통해 Marketstack 데이터를 MCP 호환 에이전트 및 시스템에 간편하게 통합할 수 있습니다.

필수 조건

• Node.js(v18 이상 권장)
• npm(Node.js와 함께 제공)
• 마켓스택 API 키
• (선택 사항) MCP 호환 클라이언트 또는 러너(예: VSCode 확장, CLI)

설정

1. 저장소를 복제하거나 프로젝트 디렉토리에 있는지 확인하세요.
2. 종속성 설치:지엑스피1
3. 구성:
   • https://marketstack.com/ 에서 Marketstack API 키를 받으세요.
   • MCP 러너 설정을 통해 MARKETSTACK_API_KEY 환경 변수를 구성하세요. 이는 MCP 클라이언트와의 원활한 통합을 위해 권장되는 방법입니다. MCP 러너를 통해 실행할 때는 .env 파일을 사용하지 마세요.

건물과 운영

1. 서버를 빌드하세요:
   npm run build
   이렇게 하면 컴파일된 JavaScript 코드가 포함된 build 디렉토리가 생성됩니다.
2. 서버를 실행합니다:
   npm run start
   또는 직접:
   node build/index.js
3. MCP 러너를 통해: stdio 전송을 사용하여 서버를 실행하도록 MCP 클라이언트를 구성합니다. MCP 설정 항목 예시( /path/to/mcp-marketstack 실제 경로로 변경하고 YOUR_API_KEY_HERE 실제 키로 대체):
   "marketstack": { "transportType": "stdio", "command": "node", "args": [ "/path/to/mcp-marketstack/build/index.js" ], "env": { "MARKETSTACK_API_KEY": "YOUR_API_KEY_HERE" } // ... other optional settings ... }

사용 가능한 도구

서버는 Marketstack API 엔드포인트를 기능별로 분류된 고유한 MCP 도구로 노출합니다.

• 시장 데이터
• 참조 데이터
• 금융 상품

각 도구에 대한 자세한 입력 스키마와 설명은 MCP 에이전트가 서버에 접속하여 내성을 통해 자동으로 검색할 수 있습니다.

프로젝트 구조

이 프로젝트는 모듈식 구조를 따릅니다.

캐싱

서버는 도구 응답을 위해 메모리 내 LRU(Least Recently Used) 캐시를 구현합니다. 이를 통해 Marketstack API에 대한 중복 호출을 줄이고 성능을 향상시키며 속도 제한을 준수할 수 있습니다.

• 메커니즘: 캐시는 도구 이름과 입력 매개변수를 기반으로 응답을 저장합니다.
• 구성 가능한 TTL: 각 도구에는 캐시된 데이터에 대해 구성 가능한 TTL(Time To Live)이 있으며, src/cacheConfig.ts 에 정의되어 있습니다. 이를 통해 각 Marketstack 엔드포인트에서 제공하는 데이터의 업데이트 빈도에 따라 서로 다른 캐싱 기간을 설정할 수 있습니다.

라이센스

이 프로젝트는 자유 소프트웨어 재단에서 공표한 GNU 일반 공중 사용 허가서(GNU General Public License) 버전 3 또는 (사용자의 선택에 따라) 이후 버전에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

기여하다

기여를 환영합니다! 표준 포크 앤 풀 요청 워크플로를 따라주세요.

지원하다

문제나 질문이 있으시면 GitHub 저장소에 이슈를 열어주세요.