sc-mcp

Подключите свой брокерский счет Scalable Capital к любому ассистенту, поддерживающему MCP. Этот сервер — тонкая, ориентированная на чтение обёртка вокруг официального CLI sc от Scalable Capital: агенты получают ваш портфель, сделки, аналитику, котировки, графики, список наблюдения и оповещения с одинаковыми настройками в Claude Code, Claude Desktop, Codex, Cursor и VS Code.

Возможности

• Живые данные брокера — обзор, активы, транзакции, аналитика, разбивка денежных средств, графики производительности, котировки, новости по ценным бумагам.

• Дополнительные функции управления портфелем — список наблюдения, ценовые оповещения, группы портфелей и конфигурация планов сбережений.

• Быстро по умолчанию — ответы на чтение кэшируются в SQLite-файле (сохраняется после перезапусков, см. Конфигурация).

• Безопасность прежде всего — никаких сделок, никаких ордеров. Инструменты записи отключены, если вы не согласитесь; команды, связанные с движением денег, отсутствуют по замыслу.

• Работает везде — обычный stdio для десктопных клиентов, HTTP для удаленного доступа или полностью самодостаточный Docker-образ.

[!Warning] Неофициальный. Сообщество обёртка вокруг CLI sc от Scalable Capital — не аффилирована и не одобрена Scalable Capital. Временное решение до появления официального MCP-сервера, которое, вероятно, будет удалено после его появления.

Без гарантий. Предоставляется "как есть" по лицензии MIT; никакой ответственности за потери, ущерб, неверные данные или любые финансовые последствия. Не является финансовой консультацией — проверяйте любую информацию, на основе которой действуете.

Инструменты

Инструменты только для чтения обращаются к брокеру в реальном времени; успешные ответы кэшируются на 5 минут (настраивается) в SQLite-файле, который сохраняется после перезапусков.

⚠️ = требуется SC_MCP_ENABLE_WRITES=true, по умолчанию отключено.

CLI sc также предоставляет trade и savings-plans add/remove. Они намеренно не предоставлены — команды, связанные с движением денег, полностью выходят за рамки (инструменты записи выше затрагивают только списки наблюдения, оповещения и группы).

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

Выберите один путь — все три приводят к работающему серверу:

Плагин Claude Code

/plugin marketplace add NinjaEde/mcp-scalable-capital
/plugin install sc-mcp

Это регистрирует MCP-сервер scalable-capital и навык, который сообщает Claude, когда и как использовать инструменты.

Однострочник uvx

uvx --from git+https://github.com/NinjaEde/mcp-scalable-capital@v0.2.0 sc-mcp

Укажите любой MCP-клиент на эту команду (sc-mcp запущен через stdio, зафиксируйте тег согласно Версионирование).

Требования

1. uv в PATH — пропустите с Docker.

2. CLI sc в PATH (см. Аутентификация).

3. Аутентифицированная сессия: sc login (см. Аутентификация).

Docker объединяет и CLI, и этот сервер, так что единственный ручной шаг там — вход в систему ниже.

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

Каждый инструмент sc_* вызывает официальный CLI sc от Scalable Capital, который должен быть установлен и авторизован один раз на машине (или на том Docker).

Установка CLI

macOS (Homebrew):

brew install scalablecapital/tap/scalable-cli

Linux (также бинарник, встроенный в Docker-образ): скачайте официальную сборку для вашей архитектуры и поместите sc в PATH:

ARCH=$(uname -m)   # x86_64 or aarch64
curl -fSL "https://github.com/ScalableCapital/scalable-cli/releases/download/v0.6.0/sc-v0.6.0-linux-${ARCH}-gnu.tar.gz" -o /tmp/sc.tar.gz
tar xzf /tmp/sc.tar.gz -C /tmp
sudo install -m 0755 /tmp/sc-v0.6.0-linux-${ARCH}-gnu/sc /usr/local/bin/sc

Проверьте:

sc --version   # e.g. "sc 0.6.0"

Вход в систему (один раз)

sc login       # device flow: open the printed URL, confirm, done
sc whoami      # confirm the session works

Если позже инструмент сообщит "session may have expired — try sc login", просто выполните sc login снова.

Где хранится сессия

~/.config/scalable-cli/:

Безголовые / среды без связки ключей (Docker, CI, серверы): CLI по умолчанию использует системную связку ключей. Если её нет, укажите путь к обычному файлу (Docker-образ делает это за вас в docker/entrypoint.sh):

# ~/.config/scalable-cli/config.toml
[auth]
session_backend = "file"

Затем снова выполните sc login — сессия сохранится в session.json и будет сохраняться после перезапусков.

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

docker cp ~/.config/scalable-cli/session.json sc-mcp:/home/sc/.config/scalable-cli/session.json
docker compose restart

Относитесь к этому файлу как к паролю — никогда не коммитьте его.

Интеграция с клиентами

Claude Code (вручную)

claude mcp add scalable-capital -- uvx --from git+https://github.com/NinjaEde/mcp-scalable-capital@v0.2.0 sc-mcp

Cursor

Добавить в Cursor — или добавьте в .cursor/mcp.json (или ~/.cursor/mcp.json):

{
  "mcpServers": {
    "scalable-capital": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/NinjaEde/mcp-scalable-capital@v0.2.0", "sc-mcp"]
    }
  }
}

Codex

Добавьте в ~/.codex/config.toml:

[mcp_servers.scalable-capital]
command = "uvx"
args = ["--from", "git+https://github.com/NinjaEde/mcp-scalable-capital@v0.2.0", "sc-mcp"]

Claude Desktop (пакет, без редактирования конфигурации)

Скачайте sc-mcp.mcpb, затем в Claude Desktop перейдите в Settings → Extensions → Install Extension и выберите файл.

[!Note] Если Claude Desktop не может найти uvx, откройте настройки расширения и укажите полный путь (например, /opt/homebrew/bin/uvx). GUI-приложения на macOS не всегда наследуют ваш PATH из оболочки.

VS Code / другие MCP-клиенты

{
  "mcpServers": {
    "scalable-capital": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/NinjaEde/mcp-scalable-capital@v0.2.0", "sc-mcp"]
    }
  }
}

Зафиксируйте тег @v0.2.0 (см. Версионирование). Удалите его, чтобы отслеживать последнюю версию main.

Docker

Весь стек — этот сервер и CLI sc — работает в контейнерах, так что вам нужен только Docker (без локального uv, Python или sc):

docker compose up -d --build              # build + start on http://localhost:8000/mcp
docker compose run --rm sc-login          # first time only — interactive device flow

Сессия хранится в томе sc-cli-config и сохраняется после перезапусков. Запись остаётся отключённой, если вы не установите SC_MCP_ENABLE_WRITES: "true" в docker-compose.yml.

Укажите любой HTTP-совместимый MCP-клиент на URL сервера:

{
  "mcpServers": {
    "scalable-capital": {
      "type": "http",
      "url": "http://localhost:8000/mcp"
    }
  }
}

Контейнер общается с scalable.capital напрямую. URL устройства из sc login работает так же, как на вашем хосте; просто перейдите по нему в браузере. Образ уже содержит конфигурацию session_backend = "file" (см. Аутентификация).

Совместимость

Протестировано с sc 0.6.x. CLI находится в предрелизной стадии, и его набор команд может меняться между минорными версиями; сервер записывает предупреждение в stderr при запуске, если ваш установленный sc отличается от протестированной major.minor. sc — это внешний бинарник, а не зависимость Python, так что это единственная доступная проверка. Если вы видите предупреждение и инструмент работает некорректно, несовпадение, скорее всего, является причиной.

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

Разработка

uv sync
uv run sc-mcp          # starts the stdio server
# or
SC_MCP_TRANSPORT=streamable-http uv run sc-mcp
uv run pytest

Как оставаться синхронизированным с sc (когда добавлять/обновлять инструменты, обновлять SUPPORTED_SC_VERSION, инварианты только для чтения) описано в CLAUDE.md.

Версионирование

SemVer — инструменты являются публичным API:

Релизы помечаются тегом vX.Y.Z; фиксируйте тег при установке через uvx --from git+..., который в противном случае отслеживает ветку по умолчанию и может изменить ваш набор инструментов. Большинство обновлений вызваны изменениями CLI sc (см. Совместимость); версия относится к самому пакету, а не к версии sc.

Лицензия

MIT