Примечание: Использование MCP-сервера требует установки и настройки как самого MCP-сервера, так и MCP-клиента.

# Установка из PyPI
uvx finam-mcp-server@latest

Примечание: Если у вас ещё нет uv, установите его сначала и перезапустите терминал, чтобы uv/uvx стали доступны. См. официальное руководство: https://docs.astral.sh/uv/getting-started/installation/

Затем добавьте в конфигурацию вашего MCP-клиента:

Расположение конфигурационных файлов:

• Claude Desktop: ~/Library/Application Support/Claude/claudedesktopconfig.json (Mac) или %APPDATA%\Claude\claudedesktopconfig.json (Windows)
• Cursor: ~/.cursor/mcp.json (Mac/Linux) или %USERPROFILE%\.cursor\mcp.json (Windows)

{   "mcpServers": {     "finam": {       "command": "uvx",       "args": ["finam-mcp-server@latest"],       "env": {         "FINAMAPIKEY": "ваш-api-ключ",         "FINAMACCOUNTID": "ваш-account-id"       }     }   } }

Клонируйте репозиторий и перейдите в директорию:

git clone https://github.com/Alexander-Panov/finam-mcp.git cd finam-mcp

Установите зависимости:

# С использованием uv (рекомендуется) uv sync

Или pip
pip install -e .

После установки/клонирования и активации виртуального окружения структура директорий должна выглядеть так:

finam-mcp/                  ← Рабочая директория (корень проекта) ├── src/                    ← Исходный код пакета │   ├── init.py │   ├── cli.py              ← Интерфейс командной строки │   ├── config.py           ← Управление конфигурацией │   ├── main.py             ← Главный MCP-сервер │   ├── middleware.py       ← Middleware для аутентификации │   ├── servers/            ← Специализированные MCP-серверы │   │   ├── account.py      ← Операции со счётом │   │   ├── assets.py       ← Работа с инструментами │   │   ├── market_data.py  ← Рыночные данные │   │   └── order.py        ← Торговые операции │   └── tradeapi/           ← Обёртки над Finam Trade API │       ├── finam.py        ← Основной клиент │       └── order/          ← Модели и клиент для ордеров ├── tests/                  ← Тесты ├── .venv/                  ← Виртуальное окружение ├── fastmcp.json            ← Конфигурация FastMCP ├── pyproject.toml          ← Конфигурация пакета ├── README.md └── LICENSE

• Какой у меня текущий баланс счёта на Finam?
• Покажи мои текущие позиции на счёте Finam.
• Купи 10 акций Сбербанка по рыночной цене.
• Продай 5 акций Газпрома с лимитной ценой 150 рублей.
• Отмени все открытые ордера.
• Покажи все мои активные заявки.

• Покажи дневную историю цен Сбербанка за последние 5 торговых дней.
• Какая была цена закрытия Газпрома вчера?
• Получи последний бар для Лукойла.
• Покажи текущую котировку для Яндекса.
• Получи 5-минутные свечи для Сбербанка за последние 2 часа.

• Найди информацию об инструменте SBER@MOEX.
• Покажи все доступные акции на Московской бирже.
• Получи расписание торгов на сегодня.

• getaccountinfo() - Просмотр баланса и статуса счёта
• get_transactions() - История транзакций
• get_trades() - История сделок

• get_assets() - Список всех торговых инструментов с фильтрацией
• getassetparams() - Параметры конкретного инструмента
• get_exchanges() - Список бирж
• getexchangeinfo() - Информация о конкретной бирже
• getoptionboards() - Информация о площадках опционов
• gettradeschedule() - Расписание торговых сессий

• get_candles() - Исторические свечи с различными таймфреймами
• get_quotes() - Текущие котировки
• getorderbook() - Стакан заявок
• getlasttrades() - Последние сделки

• get_orders() - Получение всех или отфильтрованных ордеров
• place_order() - Размещение ордера (market, limit, stop)
• cancel_order() - Отмена конкретного ордера
• cancelallorders() - Отмена всех открытых ордеров

Примечание: Предполагается, что все предварительные требования установлены.

Метод: uvx (Рекомендуется)

Простой и современный подход:

• Откройте Claude Desktop → Settings → Developer → Edit Config

• Добавьте эту конфигурацию:

{
     "mcpServers": {
       "finam": {
         "type": "stdio",
         "command": "uvx",
         "args": ["finam-mcp-server@latest"],
         "env": {
           "FINAMAPIKEY": "ваш-api-ключ",
           "FINAMACCOUNTID": "ваш-account-id"
         }
       }
     }
   }

• Перезапустите Claude Desktop и начинайте торговать!

Примечание: Предполагается, что все предварительные требования установлены.

Официальная документация по настройке MCP в Cursor: https://docs.cursor.com/context/mcp

Использование JSON конфигурации

Откройте и отредактируйте ~/.cursor/mcp.json (macOS/Linux) или %USERPROFILE%\.cursor\mcp.json (Windows):

{
  "mcpServers": {
    "finam": {
      "type": "stdio",
      "command": "uvx",
      "args": ["finam-mcp-server@latest"],
      "env": {
        "FINAMAPIKEY": "ваш-api-ключ",
        "FINAMACCOUNTID": "ваш-account-id"
      }
    }
  }
}

VS Code поддерживает MCP серверы через режим агента GitHub Copilot. Официальная документация: https://code.visualstudio.com/docs/copilot/chat/mcp-servers

Примечание: Предполагается, что все предварительные требования установлены.

1. Включите поддержку MCP в VS Code

• Откройте настройки VS Code (Ctrl/Cmd + ,)
• Найдите "chat.mcp.enabled" и отметьте галочку для включения поддержки MCP
• Найдите "github.copilot.chat.experimental.mcp" и отметьте галочку для использования файлов инструкций

2. Настройте MCP сервер (рекомендуется uvx)

Рекомендация: Используйте конфигурацию для конкретного workspace (.vscode/mcp.json) вместо общей конфигурации пользователя.

Для настроек workspace:

• Создайте .vscode/mcp.json в корне вашего проекта
• Добавьте конфигурацию Finam MCP сервера вручную в файл mcp.json:

{
      "mcp": {
        "servers": {
          "finam": {
            "type": "stdio",
            "command": "uvx",
            "args": ["finam-mcp-server@latest"],
            "env": {
              "FINAMAPIKEY": "ваш-api-ключ",
              "FINAMACCOUNTID": "ваш-account-id"
            }
          }
        }
      }
    }