Сервер 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.

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

Tools

View all tools

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

Related MCP Servers

Angle One MCP Server
baba786
-
security
F
license
-
quality
An MCP server implementation that integrates with Angle One APIs to provide standardized access to financial market data, trading operations, and portfolio management.
Last updated -
Python
AlphaVantage MCP Server
lifejwang11
-
security
A
license
-
quality
An MCP server that integrates with the AlphaVantage financial data API, providing access to stock market data, technical indicators, and fundamental financial information.
Last updated -
Python
MIT License
Alpha Vantage MCP Server
deepsuthar496
A
security
F
license
A
quality
An MCP server that provides real-time financial data integration with Alpha Vantage's API, enabling access to stock market data, cryptocurrency prices, forex rates, and technical indicators.
Last updated -
7
2
JavaScript
CoinStats MCP Serverofficial
CoinStatsHQ
A
security
A
license
A
quality
MCP Server for the CoinStats API. Provides access to cryptocurrency market data, portfolio tracking, and news.
Last updated -
30
89
3
TypeScript
MIT License

View all related MCP servers

Marketstack MCP Server