Подключить Alpha Vantage MCP к Gemini CLI

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Alpha Vantage, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Alpha Vantage + Gemini

Рыночные данные Alpha Vantage: котировки акций и дневная или внутридневная история цен бирж всего мира, фундаментальные показатели и прибыль компаний, дивиденды, сделки инсайдеров и институциональные владения, профили ETF, опционы, индексы, валюты, криптовалюты, сырьё, экономические индикаторы США, технические индикаторы и новости с оценкой тональности. Только чтение; бесплатный API-ключ даёт 25 запросов в день.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

ALPHA_VANTAGE_API_KEY

Шаг 1 — Получите учётные данные

Настройка занимает около минуты. Нужен API-ключ Alpha Vantage; для бесплатного достаточно адреса e-mail.

1. Получите бесплатный ключ на https://www.alphavantage.co/support/#api-key.
2. Вставьте его в ALPHA_VANTAGE_API_KEY. Он передаётся как параметр запроса apikey.
3. Установите коннектор и запустите alpha_vantage_get_market_status: он покажет, какие фондовые, валютные и криптовалютные рынки сейчас открыты, и подтвердит ключ.

Тарифы: бесплатный ключ даёт 25 запросов в день. Премиум-тарифы (https://www.alphavantage.co/premium/) поднимают лимит до 75 и более запросов в минуту и открывают данные США в реальном времени, внутридневную историю, скорректированные дневные ряды, опционы и пакетные котировки. При 25 вызовах в день ИИ выбирает один инструмент, который отвечает на вопрос, а не пробует несколько.

Тикеры: тикеры США пишутся просто (IBM); у других бирж есть суффикс, например TSCO.LON, SAP.DEX, RELIANCE.BSE или SHOP.TRT. Если точный тикер неизвестен, ИИ сначала ищет его через alpha_vantage_search_symbols.

Что он читает:

• Цены: последняя котировка акции или ETF, котировки в реальном времени для до 100 тикеров США за раз (премиум), дневная, недельная и месячная история за 20 с лишним лет, без корректировки или с учётом сплитов и дивидендов, и внутридневные бары акций США от 1 до 60 минут. Статус рынков мира и 20 лидеров роста, падения и оборота среди тикеров США за день.
• Анализ компании: обзор с сектором, мультипликаторами, маржой и целевой ценой аналитиков; годовые и квартальные отчёты о прибылях и убытках, балансы и отчёты о движении денежных средств; прибыль на акцию с отклонениями от прогноза; прогнозы аналитиков по EPS и выручке; число акций в обращении; дивиденды и сплиты; сделки инсайдеров; институциональные владения; стенограммы earnings call с 2010Q1.
• Фонды и индексы: профили ETF с составом и распределением по секторам и история более 200 рыночных индексов, таких как SPX, NDX или VIX.
• Опционы (премиум): текущая опционная цепочка США с греками и подразумеваемой волатильностью или цепочка прошлого торгового дня начиная с 2008 года.
• Новости: статьи о тикерах или темах с общей тональностью и тональностью по каждому тикеру.
• Валюты и криптовалюты: курс любой пары, обычной или криптовалютной, и дневная, недельная или месячная история (внутридневная на премиуме).
• Макроэкономика: реальный ВВП США, доходности казначейских облигаций, ставка по федеральным фондам, CPI, инфляция, безработица, занятость вне сельского хозяйства, розничные продажи и заказы на товары длительного пользования; сырьё, например WTI, Brent, природный газ, медь, пшеница и кофе; спотовые цены и история золота и серебра.
• Более 50 технических индикаторов, например SMA, EMA, RSI, MACD, полосы Боллинджера, ADX или ATR.

Форматы данных: числа приходят строками, часто с пронумерованными ключами вроде "05. price". Временные ряды представляют собой объекты с датой (YYYY-MM-DD) или временной меткой в качестве ключа, от новых к старым; внутридневные метки даны по восточному времени США. Фундаментальные данные указаны в валюте отчётности (reportedCurrency) и в полных единицах, а "None" означает, что показатель не раскрыт. Дневные данные даются на конец дня, если не задан премиальный entitlement. Оценка тональности идёт от -1 (медвежья) до 1 (бычья).

Объём данных, без постраничного вывода: каждый вызов возвращает ответ целиком. outputsize compact (здесь по умолчанию) даёт последние 100 точек; full может вернуть 20 лет. Технические индикаторы всегда охватывают всю историю интервала, поэтому для длинных периодов ИИ берёт недельные или месячные данные. Для опционов он задаёт expiration, чтобы цепочка оставалась небольшой.

Только чтение: все инструменты только читают, поэтому подтверждать нечего и при установке ни один инструмент не отключён.

Частые ошибки: Alpha Vantage отвечает HTTP 200 даже при ошибках; коннектор превращает такие ответы в неудачные вызовы. Сообщение о лимите означает, что дневная квота (25 на бесплатном ключе) или минутная исчерпана либо вызовы шли чаще, чем примерно раз в секунду: подождите или перейдите на другой тариф. Сообщение о премиуме означает, что функции или опции нужен платный тариф; пакетные котировки на бесплатном ключе возвращают демонстрационные данные и завершаются ошибкой. "Invalid API call" означает неверный тикер или параметр. 401 означает, что ключ отклонён.

Коннектор не использует эндпоинты, отдающие только CSV (статус листинга, календарь отчётов, календарь IPO), и эндпоинты расширенной аналитики. У Alpha Vantage также есть официальный MCP-сервер на https://mcp.alphavantage.co.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Alpha Vantage.

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

Примеры запросов

• «Сколько сейчас стоят акции Apple и насколько они изменились сегодня?»
• «Сравни выручку, операционную прибыль и свободный денежный поток Microsoft и Alphabet за последние четыре финансовых года.»
• «Покажи дневные цены закрытия SAP на XETRA за последние 100 торговых дней.»
• «Какая тональность у последних новостей о NVIDIA и какие статьи самые бычьи?»
• «Как менялись доходность 10-летних казначейских облигаций США и инфляция по CPI за последние два года?»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Meta Muse
• Подключить к Microsoft Copilot