MCP Avantage
Сервер MCP для API Alpha Vantage (@missionsquad/avantage)
Этот проект предоставляет сервер Model Context Protocol (MCP), который оборачивает библиотеку @missionsquad/avantage , предоставляя функциональные возможности API Alpha Vantage в качестве инструментов для моделей изучения языка (LLM).
Обзор
Этот сервер позволяет магистрам права взаимодействовать с API Alpha Vantage для получения финансовых данных, включая:
Основные данные по акциям (временные ряды, котировки, поиск)
Фундаментальные данные (обзор компании, финансы, календари)
Данные Форекс (FX)
Данные о криптовалюте
Данные о товарах
Экономические показатели
Технические индикаторы
Альфа-разведка (новости, настроения и т. д.)
Опции данных (Премиум)
Он использует библиотеку TypeScript @missionsquad/avantage и следует архитектуре универсального шаблона сервера MCP, включая многопользовательскую обработку ключей API и управление ресурсами для клиентских экземпляров AVantage .
Основные характеристики:
Всестороннее покрытие: реализует инструменты MCP практически для всех функций, доступных в библиотеке
@missionsquad/avantage.Поддержка нескольких пользователей: безопасная обработка ключей API Alpha Vantage с помощью
extraArgs(предпочтительно) или возврат к переменным среды.Управление ресурсами: эффективное управление клиентскими экземплярами
AVantageс помощьюResourceManager.Строго типизированный: создан с помощью TypeScript, использует типы из схем
@missionsquad/avantageи Zod для параметров инструментов.Стандартный интерфейс MCP: использует
@missionsquad/fastmcpдля связи с MCP.
Related MCP server: Zentickr - Yahoo Finance MCP Server
Начиная
Предпосылки
Node.js v20 или более поздняя версия
npm или пряжа
Ключ API Alpha Vantage (получить здесь )
Настраивать
Клонировать или копировать: клонировать этот репозиторий или копировать файлы.
git clone <repository-url> mcp-avantage-server cd mcp-avantage-serverУстановить зависимости:
npm install # or yarn installНастроить среду:
Скопируйте
.env.exampleв.env.Отредактируйте
.envи установитеAPI_KEYна ваш ключ API Alpha Vantage.При желании установите
AV_PREMIUM=trueесли у вас премиум-подписка.При необходимости отрегулируйте
LOG_LEVELилиRESOURCE_CLEANUP_INTERVAL.
Постройте проект:
npm run build # or yarn buildЗапустите сервер:
npm start # or yarn startСервер будет прослушивать запросы MCP на stdio.
Аутентификация
Сервер использует стандартную схему обработки многопользовательских токенов:
extraArgs.apiKey(рекомендуется): Передайте пользовательский ключ API Alpha Vantage в полеapiKeyобъектаextraArgsво время запроса MCPcall_tool. Этот ключ не является частью схемы инструмента.Резервный вариант
.env: еслиextraArgs.apiKeyне указан, сервер использует значениеAPI_KEYиз файла.env.
Доступные инструменты
Этот сервер предоставляет многочисленные инструменты, соответствующие методам в библиотеке @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 :
Переменная | Описание | По умолчанию |
| Резервный ключ API Alpha Vantage, если его нет в |
|
| Уровень ведения журнала ( |
|
| Интервал (мс) очистки неактивных экземпляров клиента AVantage |
|
| Установите значение |
|
Структура проекта
Соответствует общей структуре шаблона сервера MCP. Ключевые файлы:
src/index.ts: Основная точка входа на сервер, определения инструментов.src/config.ts: Загрузка конфигурации.src/logger.ts: Утилита ведения журнала.src/resource-manager.ts: управляет экземплярамиAVantage.src/schemas.ts: Схемы Zod для параметров инструментов..nexus/: Документация Nexus.
Документация Nexus
Лицензия
MIT (Предполагается, что лицензия шаблона — MIT. Проверьте.)
Available Tools
94 toolsalphaIntelligence_insiderTransactionsC
Fetches aggregated insider trading information for a given symbol.
Inputs: symbol (required).
alphaIntelligence_newsSentimentsC
Fetches market news and sentiment data from Alpha Vantage.
Inputs: tickersList, topics, time_from, time_to, +2 more.
alphaIntelligence_topGainersLosersB
Retrieves the top N gainers, losers, and most actively traded US tickers.
Inputs: no named parameters.
commodities_aluminumC
Retrieves aluminum prices.
Inputs: interval, datatype.
commodities_brentCrudeOilC
Retrieves Brent crude oil prices.
Inputs: interval, datatype.
commodities_coffeeB
Retrieves coffee prices.
Inputs: interval, datatype.
commodities_copperC
Retrieves copper prices.
Inputs: interval, datatype.
commodities_cornC
Retrieves corn prices.
Inputs: interval, datatype.
commodities_cottonC
Retrieves cotton prices.
Inputs: interval, datatype.
commodities_globalIndexC
Retrieves the global commodity index.
Inputs: interval, datatype.
commodities_naturalGasC
Retrieves natural gas prices.
Inputs: interval, datatype.
commodities_sugarC
Retrieves sugar prices.
Inputs: interval, datatype.
commodities_wheatC
Retrieves wheat prices.
Inputs: interval, datatype.
commodities_wtiCrudeOilC
Retrieves West Texas Intermediate (WTI) crude oil prices.
Inputs: interval, datatype.
coreStock_bulkQuotesA
Fetches realtime quotes for multiple stock symbols (up to 100). Premium endpoint.
Inputs: symbols (required), datatype.
coreStock_dailyC
Fetches daily time series data for a stock symbol.
Inputs: symbol (required), outputsize, datatype.
coreStock_dailyAdjustedC
Fetches daily adjusted time series data for a stock symbol.
Inputs: symbol (required), outputsize, datatype.
coreStock_intradayC
Fetches intraday time series data for a stock symbol.
Inputs: symbol (required), interval (required), adjusted, extended_hours, +3 more.
coreStock_monthlyC
Fetches monthly time series data for a stock symbol.
Inputs: symbol (required), datatype.
coreStock_monthlyAdjustedB
Fetches monthly adjusted time series data for a stock symbol.
Inputs: symbol (required), datatype.
coreStock_quoteC
Fetches a global quote for a single stock symbol.
Inputs: symbol (required), datatype.
coreStock_searchC
Searches for stock symbols matching keywords.
Inputs: keywords (required), datatype.
coreStock_weeklyC
Fetches weekly time series data for a stock symbol.
Inputs: symbol (required), datatype.
coreStock_weeklyAdjustedC
Fetches weekly adjusted time series data for a stock symbol.
Inputs: symbol (required), datatype.
crypto_dailyB
Fetches daily time series data for a cryptocurrency.
Inputs: symbol (required), market (required), datatype.
crypto_exchangeRatesC
Fetches the realtime exchange rate for a cryptocurrency pair (e.g., BTC to USD).
Inputs: from_currency (required), to_currency (required).
crypto_intradayC
Fetches intraday time series data for a cryptocurrency.
Inputs: symbol (required), market (required), interval (required), outputsize, +1 more.
crypto_monthlyB
Fetches monthly time series data for a cryptocurrency.
Inputs: symbol (required), market (required), datatype.
crypto_weeklyC
Fetches weekly time series data for a cryptocurrency.
Inputs: symbol (required), market (required), datatype.
economicIndicators_cpiC
Retrieves US Consumer Price Index (CPI) data.
Inputs: interval, datatype.
economicIndicators_durableGoodsOrdersB
Retrieves US durable goods orders data.
Inputs: datatype.
economicIndicators_federalFundsRateB
Retrieves the effective federal funds rate.
Inputs: interval, datatype.
economicIndicators_inflationC
Retrieves US inflation rate data.
Inputs: datatype.
economicIndicators_nonfarmPayrollC
Retrieves US nonfarm payroll data.
Inputs: datatype.
economicIndicators_realGDPB
Retrieves US Real Gross Domestic Product (GDP) data.
Inputs: interval, datatype.
economicIndicators_realGDPPerCapitaC
Retrieves US Real GDP per Capita data.
Inputs: datatype.
economicIndicators_retailSalesC
Retrieves US retail sales data.
Inputs: datatype.
economicIndicators_treasuryYieldC
Retrieves US Treasury yield curve data for various maturities.
Inputs: interval, maturity, datatype.
economicIndicators_unemploymentRateC
Retrieves US unemployment rate data.
Inputs: datatype.
forex_dailyC
Fetches daily time series data for a Forex pair.
Inputs: from_symbol (required), to_symbol (required), outputsize, datatype.
forex_exchangeRatesC
Fetches the realtime exchange rate for a currency pair (e.g., EUR to USD).
Inputs: from_currency (required), to_currency (required).
forex_intradayB
Fetches intraday time series data for a Forex pair.
Inputs: from_symbol (required), to_symbol (required), interval (required), outputsize, +1 more.
forex_monthlyC
Fetches monthly time series data for a Forex pair.
Inputs: from_symbol (required), to_symbol (required), datatype.
forex_weeklyB
Fetches weekly time series data for a Forex pair.
Inputs: from_symbol (required), to_symbol (required), datatype.
fundamentalData_balanceSheetC
Fetches balance sheet data (annual/quarterly). Premium endpoint.
Inputs: symbol (required).
fundamentalData_cashFlowB
Fetches cash flow data (annual/quarterly). Premium endpoint.
Inputs: symbol (required).
fundamentalData_companyOverviewC
Fetches company overview details. Premium endpoint.
Inputs: symbol (required).
fundamentalData_dividendsC
Fetches historical dividend data for a symbol.
Inputs: symbol (required).
fundamentalData_earningsC
Fetches earnings data (annual/quarterly). Premium endpoint.
Inputs: symbol (required).
fundamentalData_earningsCalendarC
Fetches upcoming earnings calendar (CSV endpoint).
Inputs: symbol, horizon.
fundamentalData_etfProfileC
Fetches ETF profile details.
Inputs: symbol (required).
fundamentalData_incomeStatementC
Fetches income statement data (annual/quarterly). Premium endpoint.
Inputs: symbol (required).
fundamentalData_ipoCalendarB
Fetches upcoming IPO calendar (CSV endpoint).
Inputs: no named parameters.
fundamentalData_listingStatusC
Fetches active or delisted symbols (CSV endpoint).
Inputs: symbol, date, state.
fundamentalData_splitsC
Fetches historical stock split data for a symbol.
Inputs: symbol (required).
optionsData_historicalOptionsC
Fetches historical options chain data. Premium endpoint.
Inputs: symbol (required), date, datatype.
optionsData_realtimeOptionsC
Fetches realtime options chain data. Premium endpoint.
Inputs: symbol (required), contract, datatype.
technicalIndicators_adD
Chaikin A/D Line
Inputs: symbol (required), interval (required), datatype, month.
technicalIndicators_adoscD
Chaikin A/D Oscillator
Inputs: symbol (required), interval (required), datatype, month, +2 more.
technicalIndicators_aroonD
Aroon
Inputs: symbol (required), interval (required), time_period (required), datatype, +1 more.
technicalIndicators_aroonoscD
Aroon Oscillator
Inputs: symbol (required), interval (required), time_period (required), datatype, +1 more.
technicalIndicators_atrD
Average True Range (ATR)
Inputs: symbol (required), interval (required), time_period (required), datatype, +1 more.
technicalIndicators_bbandsD
Bollinger Bands (BBANDS)
Inputs: symbol (required), interval (required), time_period (required), series_type (required), +2 more.
technicalIndicators_demaD
Double Exponential Moving Average (DEMA)
Inputs: symbol (required), interval (required), time_period (required), series_type (required), +2 more.
technicalIndicators_dxD
Directional Movement Index (DX)
Inputs: symbol (required), interval (required), time_period (required), datatype, +1 more.
technicalIndicators_emaC
Exponential Moving Average (EMA)
Inputs: symbol (required), interval (required), time_period (required), series_type (required), +2 more.
technicalIndicators_htDcperiodD
Hilbert Transform - Dominant Cycle Period
Inputs: symbol (required), interval (required), series_type (required), datatype, +1 more.
technicalIndicators_htDcphaseD
Hilbert Transform - Dominant Cycle Phase
Inputs: symbol (required), interval (required), series_type (required), datatype, +1 more.
technicalIndicators_htPhasorC
Hilbert Transform - Phasor Components
Inputs: symbol (required), interval (required), series_type (required), datatype, +1 more.
technicalIndicators_htSineD
Hilbert Transform - Sine Wave
Inputs: symbol (required), interval (required), series_type (required), datatype, +1 more.
technicalIndicators_htTrendlineC
Hilbert Transform - Instantaneous Trendline
Inputs: symbol (required), interval (required), series_type (required), datatype, +1 more.
technicalIndicators_htTrendmodeC
Hilbert Transform - Trend vs Cycle Mode
Inputs: symbol (required), interval (required), series_type (required), datatype, +1 more.
technicalIndicators_kamaC
Kaufman Adaptive Moving Average (KAMA)
Inputs: symbol (required), interval (required), time_period (required), series_type (required), +2 more.
technicalIndicators_mamaC
MESA Adaptive Moving Average (MAMA)
Inputs: symbol (required), interval (required), series_type (required), datatype, +3 more.
technicalIndicators_mfiD
Money Flow Index (MFI)
Inputs: symbol (required), interval (required), time_period (required), datatype, +1 more.
technicalIndicators_midpointD
Midpoint over period
Inputs: symbol (required), interval (required), time_period (required), series_type (required), +2 more.
technicalIndicators_midpriceC
Midpoint price over period
Inputs: symbol (required), interval (required), time_period (required), datatype, +1 more.
technicalIndicators_minusDID
Minus Directional Indicator (-DI)
Inputs: symbol (required), interval (required), time_period (required), datatype, +1 more.
technicalIndicators_minusDMD
Minus Directional Movement (-DM)
Inputs: symbol (required), interval (required), time_period (required), datatype, +1 more.
technicalIndicators_natrD
Normalized Average True Range (NATR)
Inputs: symbol (required), interval (required), time_period (required), datatype, +1 more.
technicalIndicators_obvD
On Balance Volume (OBV)
Inputs: symbol (required), interval (required), datatype, month.
technicalIndicators_plusDID
Plus Directional Indicator (+DI)
Inputs: symbol (required), interval (required), time_period (required), datatype, +1 more.
technicalIndicators_plusDMD
Plus Directional Movement (+DM)
Inputs: symbol (required), interval (required), time_period (required), datatype, +1 more.
technicalIndicators_rocrD
Rate of change ratio (ROCR)
Inputs: symbol (required), interval (required), time_period (required), series_type (required), +2 more.
technicalIndicators_sarD
Parabolic SAR
Inputs: symbol (required), interval (required), datatype, month.
technicalIndicators_smaD
Simple Moving Average (SMA)
Inputs: symbol (required), interval (required), time_period (required), series_type (required), +2 more.
technicalIndicators_t3D
Triple Exponential Moving Average (T3)
Inputs: symbol (required), interval (required), time_period (required), series_type (required), +2 more.
technicalIndicators_temaD
Triple Exponential Moving Average (TEMA)
Inputs: symbol (required), interval (required), time_period (required), series_type (required), +2 more.
technicalIndicators_trangeD
True Range
Inputs: symbol (required), interval (required), datatype, month.
technicalIndicators_trimaD
Triangular Moving Average (TRIMA)
Inputs: symbol (required), interval (required), time_period (required), series_type (required), +2 more.
technicalIndicators_trixC
1-day Rate Of Change (ROC) of a Triple Smooth EMA (TRIX)
Inputs: symbol (required), interval (required), time_period (required), series_type (required), +2 more.
technicalIndicators_ultoscD
Ultimate Oscillator
Inputs: symbol (required), interval (required), datatype, month.
technicalIndicators_vwapA
Volume Weighted Average Price (VWAP). Premium endpoint, requires intraday interval.
Inputs: symbol (required), interval (required), datatype, month.
technicalIndicators_wmaD
Weighted Moving Average (WMA)
Inputs: symbol (required), interval (required), time_period (required), series_type (required), +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 94 tools
Tools are well-organized into clear categories (e.g., commodities, coreStock, technicalIndicators) with distinct purposes within each category. However, some overlap exists, such as multiple time-series tools (daily, weekly, monthly) across different asset classes, which could cause confusion if an agent doesn't carefully note the category prefix.
Naming follows a highly consistent pattern throughout: category_prefix followed by snake_case descriptor (e.g., coreStock_daily, technicalIndicators_sma). This structure is predictable and aids in tool identification, with no mixing of conventions or chaotic naming.
With 94 tools, the count is excessive for a single server, making it overwhelming and difficult for an agent to navigate efficiently. While the server covers a broad financial data domain, the sheer volume suggests poor scoping, as many tools (e.g., individual technical indicators) could be consolidated into fewer, more flexible endpoints.
The tool set provides comprehensive coverage across financial data domains, including stocks, forex, crypto, commodities, economic indicators, and technical analysis. It supports full CRUD-like operations for data retrieval with various granularities (intraday to monthly) and includes premium endpoints, leaving no obvious gaps for the stated purpose of financial data access.
Maintenance
Related MCP Connectors
Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.
A Model Context Protocol server exposing real-time and historical Colombo Stock Exchange (CSE) data to AI agents and LLM applications. Provides quotes and OHLCV price history, full financial statements (income, balance sheet, cash flow), pre-computed technicals (moving averages, RS ratings, volume signals), macroeconomic indicators, corporate actions, and rule-based screening across CSE stocks and sector indices, everything needed to build CSE-aware trading assistants, research tools, and market-analysis agents. This is the official MCP server of www.ceyloncharts.com
Alpha Vantage MCP — Stock market data, fundamentals, and earnings
MCP server for Financial Modeling Prep API with 250+ financial data tools
Related MCP Servers
- AlicenseBqualityDmaintenanceA Model Context Protocol (MCP) server that provides real-time access to financial market data through the free Alpha Vantage API. This server implements a standardized interface for retrieving stock quotes and company information.12104MIT
- AlicenseNot gradedqualityCmaintenanceA Model Context Protocol server providing comprehensive access to Yahoo Finance data through the yahooquery library, enabling AI assistants to retrieve stock prices, financial statements, market data, and company analytics.12MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that retrieves real-time financial and company data using the financialdatasets API. It provides a standardized interface for integrating financial data into agentic frameworks like Agno and Smol Agent.MIT
- AlicenseBqualityDmaintenanceThis is an MCP server that provides access to the Alpha Vantage API, allowing stock data retrieval to be used as context to LLMs.245 npmMIT
Appeared in Searches
- A server for finding scientific articles, creating ad ideas, and deploying Facebook ads
- A platform for live probability option trading with indicators across multiple markets
- A server for obtaining historical cryptocurrency market data
- A tool or service for checking cryptocurrency prices
- A tool for analyzing Indian stock data for investment decisions using LLMs and news insights