AllocContext

自架 MCP 伺服器，為助理提供與持倉相關的加密資產脈絡：持倉、市場資料、情緒、宏觀、市場狀態與配置計算。

可以做什麼

AllocContext 在本機執行，提供回傳確定性 JSON 脈絡封包的工具。工具包括 get_context_bundle（完整快照）、get_market_context（情緒、宏觀、ETF 與廣度欄位）、get_context_at 與 get_context_delta（讀取已儲存快照及快照間變化），以及 get_portfolio_state（即時淨值與持倉）。check_allocation_band、check_allocation_bands 和 get_rebalance_plan 等純計算工具無需持倉憑證即可計算相對目標的偏離與美元再平衡操作。

適用情境

當助理需要可重複、以持倉為範圍的加密市場脈絡、配置偏離檢查或再平衡規劃，而且你願意自行執行資料擷取與伺服器時使用。它面向自架使用者，而非託管服務。

執行需求

在本機安裝帶 mcp 附加元件的 alloc-context Python 套件，透過 uvx 或 alloc-context 指令以 stdio 執行。需要從 config/config.example.yaml 複製設定檔，並從 .env.example 複製 .env。僅在持倉擷取或宏觀資料來源時需要唯讀交易所金鑰；ALLOC_CONTEXT_DB 環境變數指向 SQLite 狀態檔。建議使用絕對路徑。