mnemox-ai/tradememory-protocol

TradeMemory Protocol – AI取引エージェント向けローカルファーストメモリ＆安全レイヤー

概要 – AI駆動のトレーダーが行うすべての取引を記録し、トレーダー自身の過去のパフォーマンスを分析し、次の注文がブローカーのMCP（Market‑Connect‑Protocol）サーバーに到達する前に介入（拒否または再順序付け）できるオープンソースのPythonパッケージです。Alpaca、Hyperliquid、MT5、Binanceなどの一般的なブローカーAPIで動作し、ユーザー定義のリスクポリシーを強制する薄いプロキシとして実行できます。

主要コンセプト

• リコール – recall_memories(order="losses_first") は、結果、類似性、新しさ、信頼度、および「感情状態」（OWM5因子モデル）によって重み付けされた過去の負けトレードを返します。
• レコード – remember_trade は取引を5つのメモリレイヤー（エピソード、セマンティック、手続き、感情、生レコード）に書き込みます。
• リフレクト – 定期的な統計サマリー（中央値保有時間、損失集中度、Rマルチプル）がエージェントのドリフト検出を支援します。
• 監査 – すべての決定はSHA‑256でハッシュ化され、チェーン化され、毎日マークルルート化され、改ざん防止ログとしてエクスポート可能です。

使用方法

1. 履歴を同期 – tradememory sync hyperliquid --address 0x… または tradememory sync alpaca --env-file ~/.secrets/alpaca.env でフィルをローカルのSQLite DBに取り込みます。
2. メモリサーバーをエージェントに追加 – Claude Desktop（またはMCP互換エージェント）で tradememory MCPサーバーを設定します。
3. 事前フライト – エージェントが注文を提案する前に recall_memories を呼び出して類似の過去の損失を表面化します。プロキシは制限に違反する注文を自動的に拒否できます。
4. オプションのブレーキ – proxy エクストラ（pip install "tradememory-protocol[proxy]"）をインストールして、ポリシー承認済みの注文のみをブローカーに転送し、すべての決定をログに記録するローカルプロキシを実行します。

主な機能（MCPツール）

カテゴリ	ツール	目的
メモリ	remember_trade, recall_memories	取引の記録、重み付けされた損失優先リストの取得
状態	get_agent_state, get_behavioral_analysis	現在の信頼度、ドローダウン、連勝メトリクス
計画	create_trading_plan, check_active_plans	条件付き取引計画の作成
リスク	check_trade_legitimacy	5因子事前取引ゲート（フル/削減/スキップ）
監査	export_audit_trail, verify_audit_hash, verify_audit_chain	改ざん防止ログ、マークルルート
進化	evolution_* ツール	研究グレードの戦略生成とバックテスト

典型的なユースケース

• 米国株式トレーダー – 個人ユーザーがメモリサーバーをローカルで実行し、各Alpaca注文の前に「損失優先」チェックリストを取得し、日次損失上限を強制します。
• FX EAシステム – 自動化されたMT5エキスパートアドバイザーが取引を同期し、メモリレイヤーが最近の損失パターンを繰り返す注文を自動的に拒否します。
• コンプライアンス監査トレイル – 機関ユーザーがSHA‑256チェーンログをエクスポートして、MiFID IIや将来のEU AI法の要件を満たします。

制限事項（LIMITATIONS.md を参照）

• OWMスコアリングは研究グレードです。統計的有意性はまだ収集中です（現在の検証は20件未満の取引で実施）。
• 一部の注文タイプ（ブレケット、ストップリミット、トレーリング）のみが現在 拒否 され、評価はされません。
• 監査レコード用の組み込みデジタル署名はありません。改ざん防止はハッシュチェーンに依存しています。
• 進化エンジンは実験的であり、本番環境での使用は意図されていません。

インストールとクイックスタート

pip install tradememory-protocol          # コアメモリサーバー
tradememory sync hyperliquid --address 0xYourAddress
# オプションのブレーキプロキシ (Python 3.12+)
pip install "tradememory-protocol[proxy]"
tradememory proxy init --account-id <id> --symbols AAPL,MSFT

tradememory をMCPサーバーとして実行し、AIエージェントのMCP設定をそれに向けます。

セキュリティとプライバシー

• メモリサーバーはブローカーキーを保持しません。キーはプロキシが起動するブローカープロセスにのみ渡されます。
• すべてのアウトバウンドコールは読み取り専用です（MT5同期用のオプションのDiscordウェブフックを除く）。
• 監査ルートはデフォルトでRFC 3161を介してタイムスタンプされます。TRADEMEMORY_TSA=off で無効にできます。

研究ステータス

• OWM5因子スコアリングが実装され、CIテスト済みです。
• 監査トレイルは完全に機能します。
• 進化とハイブリッドベクトルリコールは研究モードです。
• 継続的な実証的検証（統計的信頼性のため目標≥100取引）。

ドキュメントとサポート

• はじめに、ユースケース、APIリファレンス、OWMフレームワーク、アーキテクチャ、中国語READMEがすべて docs/ フォルダにあります。
• 問題：ブレーキ統合 の問題を開くか、30分の無料セットアップ通話を予約してください。

ライセンス – コアパッケージはMIT。オプションの proxy エクストラは mnemox‑control（AGPL‑3.0‑only、商用ライセンスあり）を引き込みます。

金融アドバイスではありません – このツールは過去の損失パターンを表面化するだけであり、取引決定はユーザーの責任です。