Skip to main content
Glama
Sign In
deenesjakoruzh

MCP Avantage

by MissionSquad
npmGitHub
JavaScript
12
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Provides configuration management through environment variables, allowing the server to securely store API keys and settings like premium access status, log levels, and resource cleanup intervals.

  • Enables version control and project setup through cloning the repository as part of the installation process.

  • Provides the runtime environment for the server, with v20 or later required for proper operation of the Alpha Vantage API wrapper.

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

Начиная

Предпосылки

  • Node.js v20 или более поздняя версия
  • npm или пряжа
  • Ключ API Alpha Vantage (получить здесь )

Настраивать

  1. Клонировать или копировать: клонировать этот репозиторий или копировать файлы.
    git clone <repository-url> mcp-avantage-server cd mcp-avantage-server
  2. Установить зависимости:
    npm install # or yarn install
  3. Настроить среду:
    • Скопируйте .env.example в .env .
    • Отредактируйте .env и установите API_KEY на ваш ключ API Alpha Vantage.
    • При желании установите AV_PREMIUM=true если у вас премиум-подписка.
    • При необходимости отрегулируйте LOG_LEVEL или RESOURCE_CLEANUP_INTERVAL .
  4. Постройте проект:
    npm run build # or yarn build
  5. Запустите сервер:
    npm start # or yarn start
    Сервер будет прослушивать запросы MCP на stdio.

Аутентификация

Сервер использует стандартную схему обработки многопользовательских токенов:

  1. extraArgs.apiKey (рекомендуется): Передайте пользовательский ключ API Alpha Vantage в поле apiKey объекта extraArgs во время запроса MCP call_tool . Этот ключ не является частью схемы инструмента.
  2. Резервный вариант .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_KEYРезервный ключ API Alpha Vantage, если его нет в extraArgsnull
LOG_LEVELУровень ведения журнала ( error , warn , info , debug )info
RESOURCE_CLEANUP_INTERVALИнтервал (мс) очистки неактивных экземпляров клиента AVantage1800000 (30м)
AV_PREMIUMУстановите значение true , чтобы включить премиум-доступ к конечной точке в avantagefalse

Структура проекта

Соответствует общей структуре шаблона сервера MCP. Ключевые файлы:

  • src/index.ts : Основная точка входа на сервер, определения инструментов.
  • src/config.ts : Загрузка конфигурации.
  • src/logger.ts : Утилита ведения журнала.
  • src/resource-manager.ts : управляет экземплярами AVantage .
  • src/schemas.ts : Схемы Zod для параметров инструментов.
  • .nexus/ : Документация Nexus.

Документация Nexus

Лицензия

MIT (Предполагается, что лицензия шаблона — MIT. Проверьте.)

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Tools

View all tools

Сервер протокола контекста модели, который позволяет магистрам права получать доступ к комплексным финансовым данным из API Alpha Vantage, включая цены акций, фундаментальные показатели, форекс, криптовалюты и экономические показатели.

  1. Обзор
    1. Начиная
      1. Предпосылки
      2. Настраивать
    2. Аутентификация
      1. Доступные инструменты
        1. Конфигурация
          1. Структура проекта
            1. Документация Nexus
              1. Лицензия

                Related MCP Servers

                • findata-mcp-server

                  xBlueCode
                  A
                  security
                  F
                  license
                  A
                  quality
                  This is an MCP server that provides access to the Alpha Vantage API, allowing stock data retrieval to be used as context to LLMs.
                  Last updated -
                  2
                  15
                  6
                  JavaScript

                • StockFlow MCP Server

                  twolven
                  -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol server providing real-time stock data and options analysis through Yahoo Finance, enabling LLMs to access market data, analyze stocks, and evaluate options strategies.
                  Last updated -
                  4
                  Python
                  MIT License

                • OptionsFlow MCP Server

                  twolven
                  -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol server that enables LLMs to analyze options chains, calculate Greeks, and evaluate basic options strategies through Yahoo Finance data.
                  Last updated -
                  4
                  Python
                  MIT License
                  • Apple
                  • Linux

                • Alpaca MCP Server

                  miguelyad26
                  -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol server that enables LLMs like Claude to interact with the Alpaca trading API, allowing for trading stocks, checking positions, fetching market data, and managing accounts through natural language.
                  Last updated -
                  Python
                  MIT License

                View all related MCP servers

                Appeared in Searches

                New MCP Servers

                ID: rrb3v0d7c5