# tradememory-protocol

tradememory-protocol — MCP-сервер с локальной памятью для торговых ИИ-агентов: показывает убыточные сделки перед новым ордером, а прокси может отклонить нарушающий ваши правила ордер.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1450 у репозитория
- Автор: mnemox-ai
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/mnemox-ai/tradememory-protocol
- Обновлён: 2026-10-23
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/tradememory-protocol

## Что делает

Команда `tradememory sync hyperliquid --address 0xYourAddress` забирает закрытые сделки с адреса Hyperliquid, ключ не нужен. `tradememory sync alpaca --env-file ~/.secrets/alpaca.env` читает сделки из Alpaca вашими ключами из локального файла. Повторный запуск добавляет только новые сделки. Затем команда печатает, в каких ситуациях история приносит убытки, например после двух проигрышных сделок подряд. Это статистика прошлого, не совет. Hyperliquid отдаёт только недавние сделки адреса, поэтому синхронизируйтесь пораньше.

Перед предложением сделки агент вызывает `recall_memories(order="losses_first")`: убыточные сделки идут первыми, с размером и P&L. Сервер сам просит подключённых агентов так делать. Свои сделки агент записывает через `remember_trade`.

Режим прокси пока в превью и требует Python 3.12+: `pip install "tradememory-protocol[proxy]"`. Он встаёт между агентом и MCP-сервером Alpaca и проверяет ордера по вашей политике. Символы вне списка и вход без стоп-ордера он отклоняет, закрытие позиции не блокирует. Опционы, замену ордеров, стоп-лимитные и трейлинг-ордера отклоняет без оценки.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add tradememory-protocol -- uvx tradememory-protocol
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from tradememory-protocol <команда>

### Codex

**Командой платформы**
```bash
codex mcp add tradememory-protocol -- uvx tradememory-protocol
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from tradememory-protocol <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tradememory-protocol": {
            "command": "uvx",
            "args": [
                "tradememory-protocol"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from tradememory-protocol <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "tradememory-protocol": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "tradememory-protocol"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from tradememory-protocol <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add tradememory-protocol uvx tradememory-protocol
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from tradememory-protocol <команда>

## Когда брать
- найти ситуации, в которых вы чаще теряете деньги, например после серии убытков
- подтянуть закрытые сделки с адреса Hyperliquid без ключа
- показать агенту прошлые убытки в похожих условиях до нового ордера
- отклонить ордер без стоп-ордера или с символом вне вашего списка
- заморозить все новые ордера командой `tradememory proxy halt FULL_HALT`

## Примеры запросов агенту
- Запиши через `remember_trade` мою длинную позицию по AAPL с входом $195, причина: сильный отчёт.
- Прежде чем предлагать ордер по AAPL, вызови в tradememory `recall_memories` с `order="losses_first"` и покажи мои убыточные сделки.
- Прогони этот ордер через `evaluate_order` и скажи, пропустит ли его моя политика, ничего не отправляя брокеру.

## Похожие
- [breakout-trade-planner](https://affpapa.org/nevibecode/skills/breakout-trade-planner.md) — скилл · 3500 установок
- [alpaca-trading-mcp-server](https://affpapa.org/nevibecode/skills/alpaca-trading-mcp-server.md) — скилл · 186 установок
- [alpaca-mcp-server-trading](https://affpapa.org/nevibecode/skills/alpaca-mcp-server-trading.md) — скилл · 185 установок
- [Canli Paper Trading](https://affpapa.org/nevibecode/mcp/canli-paper-trading.md) — MCP-сервер · ★ 6 у репозитория
- [hyperliquid](https://affpapa.org/nevibecode/skills/hyperliquid.md) — скилл · 8700 установок
- [trader-budget](https://affpapa.org/nevibecode/skills/trader-budget.md) — скилл · ★ 9067 у репозитория

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
