MCP-сервер Trading 212

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

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

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

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

Related MCP server: Trading 212 MCP Server

Ключевые особенности

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

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

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

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

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

• Типизированная модель ошибок — согласованная обработка аутентификации, валидации, ограничений скорости, ошибок «не найдено» и ошибок 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": "/absolute/path/to/212mcp/start.sh"
    }
  }
}

Создайте start.sh и сделайте его исполняемым:

#!/bin/bash
set -euo pipefail
set -a
source /absolute/path/to/212mcp/.env
set +a
exec bun run /absolute/path/to/212mcp/src/server.ts

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

Аккаунты

• fetch_account_cash

• fetch_account_metadata

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

• search_exchange

• search_instrument

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

• fetch_open_positions (опциональный фильтр 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.

При запуске сервер проверяет конфигурацию аутентификации и немедленно завершает работу, если учетные данные неполные.