Сервер Marketstack MCP

Сервер Model Context Protocol (MCP), который представляет различные конечные точки API Marketstack как инструменты MCP, предоставляя доступ к финансовым данным, включая данные на конец дня, внутри дня, дробления, дивиденды, тикеры, биржи, валюты, часовые пояса, облигации и данные ETF. Этот сервер упрощает интеграцию данных Marketstack в MCP-совместимые агенты и системы.

Предпосылки

Node.js (рекомендуется версия 18 или более поздняя)
npm (входит в состав Node.js)
API-ключ Marketstack
(Необязательно) MCP-совместимый клиент или средство запуска (например, расширение VSCode, CLI)

Настраивать

Клонируйте репозиторий или убедитесь, что вы находитесь в каталоге проекта.
Установить зависимости:
npm install
Конфигурация:
- Получите ключ API Marketstack по адресу https://marketstack.com/ .
- Настройте переменную среды MARKETSTACK_API_KEY через настройки вашего MCP runner. Это рекомендуемый метод для бесшовной интеграции с клиентом MCP. Избегайте использования файлов .env для этой цели при запуске через MCP runner.

Строительство и запуск

Сборка сервера:
npm run build
Это создаст каталог build со скомпилированным кодом JavaScript.
Запускаем сервер:
npm run start
или напрямую:
node build/index.js
Через MCP runner: Настройте клиент MCP для запуска сервера с использованием транспорта stdio. Пример записи настроек 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 ... }

Доступные инструменты

Сервер предоставляет конечные точки API Marketstack как отдельные инструменты 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

Кэширование

Сервер реализует кэш Least Recently Used (LRU) в памяти для ответов инструментов. Это помогает сократить избыточные вызовы API Marketstack, повышая производительность и соблюдая ограничения скорости.

Механизм: Кэш хранит ответы на основе имени инструмента и входных параметров.
Настраиваемые TTL: каждый инструмент имеет настраиваемое время жизни (TTL) для своих кэшированных данных, определенное в src/cacheConfig.ts . Это позволяет использовать различные длительности кэширования в зависимости от частоты обновления данных, предоставляемых каждой конечной точкой Marketstack.

Лицензирование

Этот проект лицензирован в соответствии с GNU General Public License, опубликованной Free Software Foundation, либо версии 3 Лицензии, либо (по вашему выбору) любой более поздней версии. Подробности см. в файле LICENSE .

Внося вклад

Вклады приветствуются! Пожалуйста, следуйте стандартному рабочему процессу fork-and-pull request.

Поддерживать

Если у вас возникли проблемы или вопросы, пожалуйста, создайте тему в репозитории GitHub.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Предоставляет различные конечные точки API Marketstack в качестве инструментов MCP, обеспечивая доступ к данным финансового рынка, включая EOD, внутридневные данные, дробления, дивиденды, тикеры, биржи и другую финансовую информацию.

Related MCP Servers

Financial Datasets MCP Serverofficial
financial-datasets
A
security
A
license
A
quality
MCP server that provides AI assistants access to stock market data including financial statements, stock prices, and market news through a Model Context Protocol interface.
Last updated -
11
433
Python
MIT License
CoinMarketCap MCP
shinzo-labs
A
security
A
license
A
quality
A Model Context Protocol implementation for the CoinMarketCap API that provides standardized access to cryptocurrency market data, exchange information, and blockchain metrics.
Last updated -
26
225
28
JavaScript
MIT License
Binance Cryptocurrency MCP
snjyor
A
security
A
license
A
quality
MCP service that provides real-time access to Binance cryptocurrency market data, allowing AI agents to fetch current prices, order books, candlestick charts, and trading statistics through natural language queries.
Last updated -
12
390
24
JavaScript
Apache 2.0
Alpaca MCP Server
cesarvarela
A
security
F
license
A
quality
MCP server that exposes Alpaca Market Data & Broker API as tools, enabling access to financial data like stock bars, assets, market days, and news through the Message Control Protocol.
Last updated -
4
11
2
TypeScript

View all related MCP servers

Marketstack MCP Server