Finam MCP Server

Дисклеймер: Это неофициальный MCP-сервер для Finam Trade API, созданный для демонстрационных и образовательных целей. Подробнее читайте в хабр-статье

MCP (Model Context Protocol) сервер для интеграции с торговой платформой Finam через Trade API.

Возможности

Сервер предоставляет доступ к следующим функциям Finam Trade API:

• Account - получение информации о счёте, транзакциях и сделках

• Assets - работа с торговыми инструментами, биржами, опционами

• Market Data - получение рыночных данных (свечи, котировки, стакан)

• Orders - создание, отмена и мониторинг торговых заявок

Технологии

• Python 3.12.6

• FastMCP - фреймворк для создания MCP-серверов

• FinamTradeApiPy - Python-обёртка для Finam Trade API

Полезные ссылки

• Документация Finam Trade API

• Postman коллекция Finam API

Быстрый старт

Установка зависимостей

Запуск сервера

Тестирование с MCP Inspector

MCP Inspector позволяет интерактивно тестировать все инструменты сервера:

Подключаемся к серверу используя адрес: "http://localhost:3000/mcp"

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

Сервер использует HTTP-заголовки для аутентификации:

• finam-api-key - API ключ из личного кабинета Finam

• finam-account-id - ID вашего торгового счёта

Получить API ключ и узнать ID торгового счета можно в личном кабинете Finam Trade.

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

Важные особенности

Формат символов инструментов

Все инструменты указываются в формате ТИКЕР@MIC:

• SBER@MOEX - Сбербанк на Московской бирже

• GAZP@MOEX - Газпром на Московской бирже

• По умолчанию используются биржи: MOEX, SPBE

Формат времени

API требует даты и время в формате ISO 8601:

• 2024-01-15T10:30:00Z

• 2024-01-15T10:30:00+03:00

TimeFrame для свечей

Доступные таймфреймы из finam_trade_api.instruments.TimeFrame:

• M1, M5, M15, M30 - минуты

• H1, H4 - часы

• D1 - день

• W1 - неделя

Поддержка

По вопросам и предложениям создавайте Issue в репозитории.