MCP-сервер Trading 212

Безопасный доступ к публичному API Trading 212 для Claude через MCP

Создано с использованием:

Обзор проекта

Этот проект предоставляет возможности публичного API Trading 212 в виде инструментов MCP, чтобы Claude Desktop мог безопасно запрашивать данные об аккаунте, рынке, ордерах, истории и «пирогах» (pies). Он предназначен для пользователей, которые хотят управлять своими портфелями с помощью естественного языка без создания пользовательского интерфейса. Основная ценность заключается в модульной архитектуре на TypeScript, структурированной обработке ошибок, строгом управлении окружением и интеграции MCP, ориентированной на инструменты.

Основные возможности

• Инструменты MCP, готовые для Claude — используйте операции Trading 212 напрямую из Claude Desktop через MCP.

• Аутентификация, совместимая с публичным API — поддерживает базовую аутентификацию Trading 212 с помощью API-ключа и API-секрета.

• Полная поддержка «пирогов» (Pies) — включает операции получения списка, получения по ID, создания, обновления, дублирования и удаления.

• Рабочие процессы с ордерами — отложенные ордера, детали ордеров, размещение/отмена лимитных, рыночных, стоп- и стоп-лимитных ордеров.

• История и экспорт — исторические ордера на основе курсора, дивиденды, транзакции и конечные точки для запроса/списка экспорта в CSV.

• Типизированная модель ошибок — согласованная обработка аутентификации, валидации, ограничений скорости (rate-limit), ошибок «не найдено» и ошибок API.

Демонстрация быстрого запуска

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

npx @modelcontextprotocol/inspector

Для режима stdio настройте команду Inspector следующим образом:

bun run src/server.ts

Технологический стек

• Язык: TypeScript (строгий режим)

• Среда выполнения: Bun 1.x (совместима с Node.js 18+)

• MCP: @modelcontextprotocol/sdk

• Валидация/Схема: zod

• Конфигурация: dotenv

• Тестирование: Bun test runner (bun test src)

Установка и настройка

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

• Bun 1.0+

• Node.js 18+

• Учетные данные публичного API Trading 212 (TRADING212_API_KEY, TRADING212_API_SECRET)

• Claude Desktop (для интеграции MCP)

Настройка

1. Клонируйте репозиторий

   git clone https://github.com/razeevascx/212mcp.git

2. Перейдите в проект

   cd 212mcp

3. Установите зависимости

   bun install

4. Настройте окружение

   cp .env.example .env

5. Укажите учетные данные в .env

   TRADING212_API_KEY=your_api_key_here
   TRADING212_API_SECRET=your_api_secret_here
   ENVIRONMENT=live
   TRANSPORT=stdio
   LOG_LEVEL=info
   DEBUG=false

6. Соберите проект

   bun run build

7. Запустите сервер

   bun run start

Проверка

• Вы должны увидеть Trading 212 MCP Server running в выводе терминала.

• В Claude Desktop откройте инструменты MCP и убедитесь, что инструменты Trading 212 отображаются в списке.

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

Используйте следующую конфигурацию MCP-сервера:

{
  "mcpServers": {
    "trading212": {
      "command": "bun",
      "args": ["run", "src/server.ts"],
      "env": {
        "TRADING212_API_KEY": "your_api_key_here",
        "TRADING212_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

Инструменты MCP

Аккаунты

• fetch_account_cash

• fetch_account_metadata

Инструменты (активы)

• search_exchange

• search_instrument

Портфель / Позиции

• fetch_open_positions

• search_specific_position_by_ticker

• fetch_open_position_by_ticker

Ордера

• fetch_all_orders

• fetch_order

• place_limit_order

• place_market_order

• place_stop_order

• place_stop_limit_order

• cancel_order

История

• fetch_historical_order_data

• fetch_paid_out_dividends

• fetch_transaction_list

• fetch_exports_list

• request_export_csv

«Пироги» (Pies)

• fetch_pies

• fetch_pie

• create_pie

• update_pie

• duplicate_pie

• delete_pie

Утилиты сервера

• get_server_health

Примечания по использованию API

• Аутентификация: Публичный API Trading 212 использует базовую аутентификацию (API_KEY:API_SECRET), обрабатываемую BaseClient.

• Маршрутизация окружения: ENVIRONMENT=demo|live соответствует базовым URL демо/реального счета Trading 212.

• Пагинация: Конечные точки истории используют limit + cursor и возвращают nextPagePath.

• Ограничения скорости: API имеет ограничения по частоте запросов; ошибка 429 возвращается как RATE_LIMIT_EXCEEDED.

Разработка

Скрипты

• bun run build — компиляция TypeScript

• bun run start — запуск MCP-сервера

• bun run dev — режим отслеживания изменений

• bun test src — запуск тестов в src

Устранение неполадок

• Отсутствуют учетные данные: установите TRADING212_API_KEY и TRADING212_API_SECRET.

• Ошибки аутентификации: пересоздайте учетные данные API и перезапустите сервер.

• Claude не может подключиться: проверьте установку Bun, путь к команде и конфигурацию MCP в Claude.