mnemox-ai/tradememory-protocol

mnemox-ai/tradememory-protocol

от mnemox-ai
MCP сервер, запоминающий каждую сделку с SHA-256 защитой. Анализируйте историю решений, выявляйте ошибки и соблюдайте нормы MiFID II и EU AI Act с помощью пре-флайт чеклистов и OWM.

TradeMemory Protocol

PyPI Tests MCP Tools Smithery License: MIT

Getting Started | Use Cases | API Reference | OWM Framework | Limitations | 中文版


TradeMemory remembers what it cost. It is an open-source, local-first memory and brake for AI trading agents: it pulls in your fills, finds where your own history loses money, puts those losing trades in front of your agent before the next order, and can refuse an order that breaks rules you set, before it reaches the broker.

Brokers now let AI agents trade over MCP, with different guardrails: Webull and tastytrade set size or buying-power limits, Interactive Brokers only lets the agent draft an order for you to submit, and Robinhood and Public set no cap you can impose on an external agent (StockBrokers, 2026-09-30). The caps are fixed numbers. None of them looks at how your own past trades went.

Start with your own history

pip install tradememory-protocol

# Hyperliquid: public fills, no key needed
tradememory sync hyperliquid --address 0xYourAddress

# Alpaca: read-only calls with your own keys, kept in a local file
tradememory sync alpaca --env-file ~/.secrets/alpaca.env

Часто задаваемые вопросы

Инструменты были проиндексированы:
check_active_plansидемпотентный

Проверяет активные торговые планы на соответствие текущему рыночному контексту. Запрашивает все активные перспективные планы, аннулирует те, срок действия которых истек, и сопоставляет оставшиеся планы с предоставленным контекстом.

Параметры
  • context_atr_d1number | null

    Текущий ATR(14) на D1 в долларах

  • context_regimestring | null

    Текущий режим рынка (восходящий тренд/нисходящий тренд/боковик/волатильный)

check_trade_legitimacyидемпотентный

Проверяет, достаточно ли у агента данных и уверенности для торговли. Вызывайте этот инструмент перед принятием любого торгового решения. Оценивает размер выборки, качество памяти, опыт работы в текущем режиме, состояние серии и просадку, чтобы определить, заслужил ли агент право торговать полным объёмом.

Параметры
  • current_atr_d1number | null

    Текущий ATR(14) на D1 в долларах (информационно).

  • current_regimestring | null

    Текущий режим рынка (восходящий тренд/нисходящий тренд/боковик/волатильный)

  • strategy_namestringобязательный

    Стратегия для оценки (например, "VolBreakout").

  • symbolstring

    Торговый инструмент (по умолчанию «XAUUSD»).

compute_dqsидемпотентный

Вычисляет Decision Quality Score перед выполнением сделки. Оценивает качество процесса принятия решения (не результата) по 5 факторам: соответствие режиму, размер позиции против Келли, соблюдение процесса (сходство с OWM), состояние риска и исторический паттерн.

Параметры
  • context_atr_d1number | null

    ATR(14) на дневном графике в долларах.

  • context_regimestring | null

    Рыночный режим (восходящий тренд / нисходящий тренд / боковик / волатильный)

  • directionstringобязательный

    Предполагаемое направление ("long" или "short").

  • market_contextstring

    Описание текущих рыночных условий.

  • proposed_lot_sizenumber

    Планируемый размер позиции в лотах (по умолчанию 0,1).

  • strategy_namestringобязательный

    Рассматриваемая стратегия (например, "VolBreakout").

  • symbolstringобязательный

    Торговый инструмент (например, "XAUUSD")

create_trading_plan

Создает проспективный торговый план, который активируется при выполнении условий. Сохраняет план на основе правил в проспективной памяти. План остается активным, пока не будет запущен, не истечет или не будет отменен вручную.

Параметры
  • expiry_daysinteger

    Дней до истечения плана (по умолчанию 30)

  • planned_actionstringобязательный

    JSON-строка, описывающая, что делать (например, '{"type": "skip_trade"}')

  • prioritynumber

    Приоритет 0-1, выше = проверяется первым (по умолчанию 0.5)

  • reasoningstringобязательный

    为什么这个计划被创建

  • trigger_conditionstringобязательный

    JSON-строка, описывающая, когда срабатывать (например, '{"режим": "диапазон"}')

  • trigger_typestringобязательный

    Тип триггера (например, "market_condition", "drawdown", "time_based")

evolution_discover_patterns

Выявляет торговые паттерны из рыночных данных с помощью анализа LLM. Использует Claude для анализа данных OHLCV и генерирует кандидатные торговые паттерны с условиями входа/выхода. Каждый паттерн впоследствии тестируется на исторических данных.

Параметры
  • countinteger

    Количество паттернов для генерации (по умолчанию 5)

  • daysinteger

    Дней истории для анализа (по умолчанию 90)

  • symbolstringобязательный

    Торговая пара (например, "BTCUSDT")

  • temperaturenumber

    Креативность LLM: диапазон 0-1 (по умолчанию 0.7, чем выше, тем разнообразнее)

  • timeframestring

    Таймфрейм баров — "5m", "15m", "1h", "4h", "1d"

evolution_evolve_strategy

Запускает полный эволюционный цикл — генерирует, тестирует на истории, отбирает, отбрасывает. Многопоколенная эволюция стратегий: LLM генерирует паттерны-кандидаты, прогоняет их на внутривыборочных данных, проверяет выжившие на вневыборочных данных и отбрасывает слабые гипотезы. Возвращает допущенные стратегии и кладбище несостоявшихся.

Параметры
  • daysinteger

    Дни истории для использования (по умолчанию 90)

  • generationsinteger

    Количество поколений эволюции (по умолчанию 3).

  • population_sizeinteger

    Гипотез на генерацию (по умолчанию 10)

  • symbolstringобязательный

    Торговая пара (например, "BTCUSDT")

  • timeframestring

    Таймфрейм баров — "5m", "15m", "1h", "4h", "1d"

evolution_fetch_market_dataидемпотентныйвнешний мир

Получает рыночные данные OHLCV с Binance для анализа эволюции. Скачивает исторические бары цен для бэктестинга и поиска паттернов. Используйте это перед discover_patterns или run_backtest, чтобы получить данные.

Параметры
  • daysinteger

    Количество дней истории для загрузки (по умолчанию 90)

  • symbolstringобязательный

    Торговая пара (например, "BTCUSDT", "ETHUSDT")

  • timeframestring

    Таймфрейм баров — "5m", "15m", "1h", "4h", "1d"

evolution_get_logтолько чтениеидемпотентный

Получает журнал прошлых запусков эволюции из этой сессии. Возвращает список всех запусков эволюции с их результатами, включая успешные стратегии, кладбище, использование токенов и количество бэктестов. Данные находятся в памяти (сбрасываются при перезапуске сервера).

Параметры

Без параметров.

evolution_run_backtestидемпотентный

Запускает бэктест кандидатного паттерна на исторических данных OHLCV. Принимает словарь паттерна (из discover_patterns) и запускает векторизованный бэктест. Возвращает метрики пригодности: коэффициент Шарпа, процент выигрышных сделок, количество сделок, максимальную просадку, суммарную PnL.

Параметры
  • daysinteger

    Количество дней истории для бэктеста (по умолчанию 90)

  • pattern_dictobjectобязательный

    CandidatePattern в виде dict (из вывода discover_patterns)

  • symbolstring

    Торговая пара (например, "BTCUSDT")

  • timeframestring

    Таймфрейм баров — "5m", "15m", "1h", "4h", "1d"

export_audit_trailтолько чтениеидемпотентный

Экспорт записей торговых решений для аудита и проверки соответствия. Предоставляет полную, защищённую от подделок запись торговых решений, включая контекст памяти (похожие сделки, убеждения), который повлиял на каждое решение.

Параметры
  • endstring | null

    Конечная дата (формат ISO, не включительно). Например, "2026-04-01".

  • limitinteger

    Максимальное количество записей для возврата (по умолчанию 50).

  • startstring | null

    Дата начала (формат ISO, включительно). Например, "2026-03-01".

  • strategystring | null

    Фильтруйте по названию стратегии (например, "VolBreakout").

  • trade_idstring | null

    Получите один TDR по идентификатору сделки (например, "MT5-7047640363"). Если указан, остальные фильтры игнорируются.

get_agent_stateтолько чтениеидемпотентный

Получает текущее аффективное состояние агента (уверенность, риск, просадка). Возвращает уровень уверенности, склонность к риску, процент просадки, серии побед/поражений, отслеживание капитала и рекомендуемое действие на основе текущей степени просадки.

Параметры

Без параметров.

get_behavioral_analysisтолько чтениеидемпотентный

Извлекает поведенческий анализ из процедурной памяти. Возвращает сводную статистику торгового поведения: время удержания, коэффициент диспозиции, вариативность размера лота и сравнение с критерием Келли.

Параметры
  • strategy_namestring | null

    Фильтрует по имени стратегии. Возвращает все, если не указано.

  • symbolstring | null

    Фильтрует по символу. Возвращает все, если не указано.

get_daily_rootидемпотентныйвнешний мир

Получает (или пересобирает) ежедневный корень Меркла для даты UTC. Корень Меркла обобщает каждую запись audit_chain, у которой значение chained_at попадает в пределы UTC-дня. Проверка этого единственного 32-байтового корня доказывает целостность каждого TDR за этот день без повторного обхода каждого из них.

Параметры
  • datestringобязательный

    Дата в формате YYYY-MM-DD (или полная дата-время по ISO).

  • include_tokenboolean

    Если значение True, включите токен tsa_token, закодированный в base64, в ответ (по умолчанию False — токен может быть большим).

  • rebuildboolean

    Если True, пересчитай и перезапиши сохранённый корень.

  • request_tsaboolean | null

    Определяет, следует ли отправлять пересобранный корневой сертификат в настроенный RFC 3161 TSA (по умолчанию freetsa.org) и сохранять возвращённый TimeStampToken. Значение None (по умолчанию) соответствует переменной окружения TRADEMEMORY_TSA - ON, если не установлено "off". Сбои TSA регистрируются, но не прерывают пересборку.

get_strategy_performanceтолько чтениеидемпотентный

Получает сводную статистику производительности по каждой стратегии. Используется для оценки того, какие стратегии работают, а какие нуждаются в корректировке.

Параметры
  • strategy_namestring | null

    Фильтрует по имени стратегии. Возвращает все стратегии, если не указано.

  • symbolstring | null

    Фильтрует по символу. Возвращает все символы, если параметр не указан.

get_trade_reflectionтолько чтениеидемпотентный

Получает полный контекст и анализ для конкретной сделки. Используйте это для глубокого погружения в логику и уроки конкретной сделки.

Параметры
  • trade_idstringобязательный

    ID сделки для поиска

recall_memoriesидемпотентный

Извлекает воспоминания с помощью OWM-оценки, взвешенной по исходам. Запрашивает эпизодические и семантические воспоминания, оценивает их по качеству исхода, схожести контекста, свежести, уверенности и аффективной модуляции. Возвращает ранжированные воспоминания с разбивкой по оценкам. Используйте order="losses_first" прямо перед тем, как совершить сделку: убыточные сделки, совершённые в похожих условиях, идут первыми, и текущее настроение (полоса убытков) больше не тянет их вниз.

Параметры
  • context_atr_d1number | null

    Текущий ATR(14) на D1 в долларах

  • context_regimestring | null

    Текущий режим рынка (восходящий тренд/нисходящий тренд/боковик/волатильный)

  • hybrid_alphanumber

    Вес смешивания Vector и OWM [0..1], когда активен гибридный режим. 0.0 = чистый OWM, 1.0 = чистый Vector. По умолчанию 0.3 (доминирует OWM).

  • limitinteger

    Максимум результатов, по умолчанию 100.

  • market_contextstringобязательный

    Текущие рыночные условия для сопоставления

  • memory_typesstring[] | null

    Типы для запроса (по умолчанию: ["эпизодический", "семантический"])

  • orderstring

    "outcome" (по умолчанию): лучшие исходы ранжируются выше (по R-множителю, если он был записан), и как минимум 20% результатов - убытки. "losses_first": каждая убыточная сделка идёт раньше всего остального, более крупные убытки при похожих условиях - первыми; поиск идёт и по недавним убыточным сделкам символа, и по его недавним сделкам. Для проверки перед сделкой.

  • strategy_namestring | null

    Необязательный фильтр стратегии.

  • symbolstringобязательный

    Торговый инструмент (например, "XAUUSD")

  • use_hybridboolean

    Если True (по умолчанию), включается гибридный скоринг vector + OWM, когда доступен бэкенд эмбеддингов. Молча переключается на чистый OWM, когда не установлен sentence-transformers.

remember_trade

Сохраняет сделку в многослойную память OWM с автоматическими обновлениями. Записывает в эпизодическую память и автоматически обновляет семантическую (байесовскую), процедурную (скользящие средние) и аффективную (EWMA доверие/серии). Также записывает в trade_records для обратной совместимости.

Параметры
  • confidencenumber

    Уровень уверенности агента 0-1 (по умолчанию 0.5)

  • context_atr_d1number | null

    ATR(14) на дневном графике в долларах.

  • context_regimestring | null

    Рыночный режим (восходящий тренд / нисходящий тренд / боковик / волатильный)

  • directionstringобязательный

    «длинный» или «короткий»

  • entry_pricenumberобязательный

    Цена входа в сделку

  • entry_timestampstring | null

    Время входа в формате ISO. Используется для вычисления длительности удержания.

  • exit_pricenumberобязательный

    Цена выхода из сделки.

  • exit_timestampstring | null

    Формат ISO времени выхода. Используется для расчета продолжительности удержания.

  • lot_sizenumber | null

    Размер позиции (лоты, акции или контракты). Без него не разглядеть такие закономерности, как увеличение объёма после серии убытков.

  • market_contextstringобязательный

    Описание рыночных условий

  • max_adverse_excursionnumber | null

    Максимальное неблагоприятное отклонение за время сделки.

  • pnlnumberобязательный

    Прибыль/убыток в валюте счета.

  • pnl_rnumber | null

    Прибыль и убыток (P&L) как R-кратное (единицы риска). Улучшает качество оценки OWM.

  • reflectionstring | null

    Чему нас научила эта сделка.

  • strategy_namestringобязательный

    Используемая стратегия (например, «VolBreakout»)

  • symbolstringобязательный

    Торговый инструмент (например, "XAUUSD")

  • timestampstring | null

    Метка времени в формате ISO. По умолчанию используется текущее время (UTC).

  • trade_idstring | null

    Необязательный пользовательский ID. Автоматически генерируется, если не указан.

validate_strategyтолько чтениеидемпотентный

Проверяет торговую стратегию с помощью статистических тестов (DSR + Walk-Forward + Regime + CPCV). Только для образовательных и исследовательских целей. Не финансовый совет. Загрузите торговый журнал в формате CSV (формат QuantConnect) или CSV с дневной доходностью. Инструмент проводит четыре статистических теста: 1. Deflated Sharpe Ratio (DSR) - обнаруживает переобучение из-за множественного тестирования. 2. Walk-Forward Validation - проверяет согласованность на данных вне выборки. 3. Regime Analysis - оценивает эффективность на бычьем, медвежьем и кризисном рынках. 4. CPCV - перекрестно проверяет стабильность коэффициента Шарпа по временным периодам.

Параметры
  • file_pathstringобязательный

    Абсолютный путь к CSV-файлу на вашем локальном компьютере.

  • formatstring

    Формат CSV — «quantconnect» для журналов сделок (колонки: Entry Time, Exit Time, Direction, Entry Price, Exit Price, Quantity, P&L, Fees, IsWin) или «returns» для ежедневной доходности (колонки: date, return или одна колонка доходности).

  • num_strategiesinteger

    Сколько стратегий вы протестировали, перед тем как выбрать эту. Выше M = строже порог DSR (компенсирует смещение выборки).

  • strategy_namestring

    Название стратегии (для отчета).

verify_audit_chainтолько чтениеидемпотентный

Проверяет целостность цепочки аудита. Проходит по цепочке от from_seq (по умолчанию: 1, генезисная запись) до to_seq (по умолчанию: последняя запись), проверяя, что prev_hash каждой записи совпадает с data_hash предыдущей записи и что каждый data_hash равен SHA256(prev_hash || content_hash). Возвращает dict с ключами: verified, checked_count, first_break_at, reason. Если first_break_at равен None, а verified=True, цепочка целостна во всём проверенном диапазоне.

Параметры
  • from_seqinteger | null

    Начальный sequence_num (включительно). None = с начала.

  • to_seqinteger | null

    Конечный sequence_num (включительно). None означает до последнего.

verify_audit_hashтолько чтениеидемпотентный

Проверяет целостность записи торгового решения. Пересчитывает SHA256 data_hash из сохранённых входных данных и сравнивает с хэшем, вычисленным в момент принятия решения. Несовпадение говорит о подделке.

Параметры
  • trade_idstringобязательный

    Идентификатор сделки для проверки (например, "MT5-7047640363").

0.5.6основная
0.5.5
0.5.4
0.5.3
0.5.2
0.5.1
0.5.0
0.4.0
0.3.1
0.3.0
0.2.0

Выберите клиент, чтобы установить mnemox-ai/tradememory-protocol:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "mnemox-ai-tradememory-protocol-ibe2f5nevn": {
      "command": "uvx",
      "args": [
        "tradememory-protocol"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "mnemox-ai-tradememory-protocol-ibe2f5nevn": {
      "command": "uvx",
      "args": [
        "tradememory-protocol"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "mnemox-ai-tradememory-protocol-ibe2f5nevn": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "tradememory-protocol"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"mnemox-ai-tradememory-protocol-ibe2f5nevn\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"tradememory-protocol\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "mnemox-ai-tradememory-protocol-ibe2f5nevn": {
      "command": "uvx",
      "args": [
        "tradememory-protocol"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add mnemox-ai-tradememory-protocol-ibe2f5nevn -- uvx tradememory-protocol

Либо через JSON-конфиг:

claude mcp add-json mnemox-ai-tradememory-protocol-ibe2f5nevn "{\"command\":\"uvx\",\"args\":[\"tradememory-protocol\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add mnemox-ai-tradememory-protocol-ibe2f5nevn -- uvx tradememory-protocol

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.mnemox-ai-tradememory-protocol-ibe2f5nevn]
command = "uvx"
args = ["tradememory-protocol"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите mnemox-ai/tradememory-protocol, а в поле команды запуска — строку ниже:
uvx tradememory-protocol

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "mnemox-ai-tradememory-protocol-ibe2f5nevn": {
      "command": "uvx",
      "args": [
        "tradememory-protocol"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "mnemox-ai-tradememory-protocol-ibe2f5nevn": {
      "command": "uvx",
      "args": [
        "tradememory-protocol"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например mnemox-ai-tradememory-protocol-ibe2f5nevn.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: mnemox-ai-tradememory-protocol-ibe2f5nevn
    command: uvx
    args:
      - "tradememory-protocol"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "mnemox-ai-tradememory-protocol-ibe2f5nevn": {
      "command": "uvx",
      "args": [
        "tradememory-protocol"
      ]
    }
  }
}

Похожие MCP-сервера

timmx7/acheron-mcp-server

timmx7/acheron-mcp-server

от timmx7

MCP сервер Acheron даёт постоянную память, общую между Claude Chat, Code и Cowork. Сохраняй решения, ищи заметки и просматривай историю — всё локально, без облака. Полезен всем, кто хочет не терять контекст между сессиями.

TypeScript⭐ 7
varun29ankuS/shodh-memory

varun29ankuS/shodh-memory

от varun29ankus

Shodh-Memory - MCP сервер для персистентной памяти AI-агентов и роботов. Запоминает суть, забывает лишнее и обучается без LLM. Использует локальные эмбеддинги и граф знаний. Работает офлайн, один б...

Rust⭐ 312
mnemoverse/mcp-memory-server

mnemoverse/mcp-memory-server

от mnemoverse

MCP сервер для долговременной памяти AI-агентов, работающий через единый API-ключ в Claude, Cursor, VS Code и ChatGPT. Запоминает факты, предпочтения и уроки между сессиями и проектами. Фидбек улучшает релевантность, а забывание по давности делает память самоочищающейся.

TypeScript⭐ 27
aitytech/agentkits-memory

aitytech/agentkits-memory

от aitytech

MCP сервер AgentKits Memory даёт AI-ассистентам постоянную память: сохраняет решения, паттерны и ошибки между сессиями. Всё хранится локально в SQLite, легко интегрируется с Claude Code, Cursor и д...

TypeScript⭐ 3
webaesbyamin/agent-receipts

webaesbyamin/agent-receipts

от webaesbyamin

MCP сервер даёт AI-агентам память с криптографическими чеками. Каждый факт подписывается Ed25519, хранится локально без облака. Для разработчиков, нуждающихся в аудите действий агента.

TypeScript⭐ 1
XJTLUmedia/Context-First-MCP

XJTLUmedia/Context-First-MCP

от xjtlumedia

MCP-сервер предотвращает потерю контекста и противоречия в длинных AI-диалогах. 37 инструментов с оркестратором context_loop автоматически проверяют контекст, выявляют неоднозначности и верифицирую...

TypeScript⭐ 2
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин