Сервер 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. Резервный вариант если extraArgs.apiKey не указан, сервер использует значение API_KEY из файла .env .

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

Этот сервер предоставляет многочисленные инструменты, соответствующие методам в библиотеке @missionsquad/avantage . Инструменты обычно называются module_method (например, coreStock_intraday , fundamentalData_companyOverview ).

Подробную информацию о параметрах и возвращаемых структурах см. в документации Alpha Vantage и типах библиотеки @missionsquad/avantage ( src/types/* в библиотеке).

Пример вызова инструмента (концептуальный запрос MCP):

Категории инструментов (модули):

• alphaIntelligence_*

• commodities_*

• coreStock_*

• crypto_*

• economicIndicators_*

• forex_*

• fundamentalData_*

• optionsData_* (Премиум)

• technicalIndicators_*

Используйте команду MCP list_tools , чтобы получить полный список доступных инструментов, их описания и схемы параметров.

Конфигурация

Настройте через файл .env :

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

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

• src/index.ts : Основная точка входа на сервер, определения инструментов.

• src/config.ts : Загрузка конфигурации.

• src/logger.ts : Утилита ведения журнала.

• src/resource-manager.ts : управляет экземплярами AVantage .

• src/schemas.ts : Схемы Zod для параметров инструментов.

• .nexus/ : Документация Nexus.

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

• .nexus/features/avantage_integration/feature.md

• .nexus/architecture/server_structure.md

• .nexus/guides/using_avantage_tools.md

• .nexus/decisions/decision_log.md

Лицензия

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