마켓스택 MCP 서버

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

필수 조건

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

Related MCP server: CoinMarketCap MCP

설정

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

건물과 운영

서버를 빌드하세요:
npm run build
이렇게 하면 컴파일된 JavaScript 코드가 포함된 build 디렉토리가 생성됩니다.
서버를 실행합니다:
npm run start
또는 직접:
node build/index.js
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 에이전트가 서버에 접속하여 내성을 통해 자동으로 검색할 수 있습니다.

프로젝트 구조

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

. ├── src/ │ ├── index.ts # Server entry point │ ├── marketstackClient.ts # Centralized API client with caching │ ├── cacheConfig.ts # Cache TTL configurations │ └── tools/ │ ├── index.ts # Registers all tool categories │ ├── marketData/ # Market Data tools │ │ └── ... │ ├── referenceData/ # Reference Data tools │ │ └── ... │ ├── financialInstruments/ # Financial Instruments tools │ │ └── ... │ └── wrapToolHandler.ts # Wrapper for tool handlers ├── memory-bank/ # Project documentation │ └── ... ├── package.json # Project dependencies and scripts ├── tsconfig.json # TypeScript configuration ├── eslint.config.js # ESLint configuration ├── .prettierrc # Prettier configuration ├── LICENSE # Project license └── README.md # This file

캐싱

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

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