🪨 PROJECT LITHOS

Институциональный количественный интеллект, SEC-аудит Calera FinSec и архитектура ICX Infinite Context для универсальных LLM через Model Context Protocol (MCP)

«Непоколебимая истина для высокоскоростных рынков: Project Lithos — это прочный детерминированный фундамент под современным количественным ИИ».

🌋 Предыстория проекта и происхождение Vibe Coding

Project Lithos был создан во время Live Stream Vibe Coding Stream как открытый образовательный эталонный стенд и пилотный полигон для Calera Labs ICX Infinite Context API и Calera Labs FinSec (FinanceSec) MCP Server.

В геологии Литосфера — это несокрушимая внешняя кора и фундамент Земли.

В финансовой количественной инженерии сочетание коммерческих LLM для рассуждений (Google Gemini 3.1 Flash-Lite, Claude 3.5 Sonnet или GPT-4o) с высокоскоростными рыночными данными и торговой инфраструктурой требует детерминированной достоверности и нулевых галлюцинаций:

1. Детерминированная прослеживаемость SEC-отчётности (Calera FinSec MCP — извлечение GAAP на корпоративной скорости $<2\text{ms}$, ковенанты, сегментная структура, 0% ошибок вычислений).

2. Бесконечная контекстная память и синхронизация дельт в реальном времени (Calera ICX A4 Lattice — субмиллисекундное ассоциативное восстановление $<1\text{ms}$, нулевое раздувание токенов).

3. Глубина стакана уровня 2 и механизм сжатия ликвидности (лестницы bid/ask в реальном времени, коэффициенты дисбаланса заявок, обнаружение сжатия ликвидности).

4. Аудит пост-трейд телеметрии HFT (точное определение узких мест маршрутизации, повторных передач TCP и проскальзывания по задержке $>50\text{ms}$).

5. Обнаружение топологических противоречий (сдвиговые пустоты $Betti-2$ между предупреждениями поставщиков и корпоративными прогнозами).

6. Локальный 5-летний SQL альфа-бэктестинг (паттерны падения и отскока, аномалии накопления объёма).

7. Криптографически защищённое исполнение брокерских операций (HMAC-токены с участием человека + Prompt Injection Shield).

Related MCP server: Sablier MCP Server

🏛️ Архитектура системы

                    ┌────────────────────────────────────────────────────────┐
                    │             Commercial Cloud Reasoning LLMs            │
                    │         (Claude 3.5 Sonnet / GPT-4o / Gemini BYOK)     │
                    └───────────────────────────┬────────────────────────────┘
                                                │
                                                ▼ ▲  (Secure JSON-RPC 2.0 / stdio / SSE)
                                                │
                    ┌───────────────────────────┴────────────────────────────┐
                    │                    Local MCP Host                      │
                    │        (Claude Desktop / Cursor / Antigravity CLI)     │
                    └───────────────────────────┬────────────────────────────┘
                                                │
                                                ▼ ▲
      ┌─────────────────────────────────────────┴─────────────────────────────────────────┐
      │                              PROJECT LITHOS MCP SERVER                            │
      │  ┌─────────────────────────────────────────────────────────────────────────────┐  │
      │  │     🛡️ SECURITY GUARD & HITL GATEWAY (HMAC Token + Prompt Injection Shield)   │  │
      │  └──────────┬──────────────┬──────────────┬──────────────┬──────────────┬──────┘  │
      └─────────────┼──────────────┼──────────────┼──────────────┼──────────────┼─────────┘
                    │              │              │              │              │
         ┌──────────┴─────┐ ┌──────┴────────┐ ┌───┴──────────┐ ┌─┴────────────┐ ┌┴──────────┐
         │ Calera FinSec  │ │  Calera ICX   │ │ Live L2 Book │ │  Local SQL   │ │ Post-Trade│
         │   Hosted MCP   │ │Infinite Memory│ │Depth & Spread│ │ Database    │ │ Logs & ACK│
         │(SEC 10-K/10-Q) │ │  (A4 Lattice) │ │  (Microstr.) │ │(5-Yr Intrad.)│ │ (>50ms)   │
         └──────────┬─────┘ └──────┬────────┘ └───┬──────────┘ └─┬────────────┘ └┬──────────┘
                    │              │              │              │              │
                    ▼              ▼              ▼              ▼              ▼
             finsec.caleralabs  icx.api.caleralabs  Polygon.io /   SQLite /       Execution
               .com/mcp          .com/v1         Alpaca Feeds   TimescaleDB    Logs & CSVs

flowchart TD
    subgraph ClientLayer["AI Client & MCP Host Layer"]
        LLM["Commercial AI (Gemini BYOK / Claude / GPT)"]
        Host["MCP Host (Claude Desktop / Cursor / Antigravity CLI)"]
        LLM <--> Host
    end

    subgraph LithosCore["Project LITHOS Core Engine"]
        Server["Project LITHOS MCP Server (server.py)"]
        Guard["🛡️ Security Guard & HITL Gateway\n(HMAC Tokens + Prompt Injection Shield)"]
        Router["⚡ Autonomous Query Router\n& Slash Dispatcher (chat.py)"]
        Host <--> Server
        Server <--> Guard
        Server <--> Router
    end

    subgraph Substrates["Integrated Substrates & Data Feeds"]
        FinSec["🏛️ Calera FinSec MCP\n(Deterministic SEC 10-K/10-Q)"]
        ICX["🌌 Calera ICX\n(4D A4 Infinite Lattice Memory)"]
        L2["📊 Level-2 Order Book\n(Imbalance & Squeeze Engine)"]
        SQL["🗄️ 5-Year SQL Database\n(Alpha Backtester)"]
        Logs["📋 Execution Log Auditor\n(Latency Anomaly Detection)"]
        Broker["💼 Alpaca Paper Broker\n(Safe Order Staging)"]
    end

    Guard --> FinSec
    Guard --> ICX
    Guard --> L2
    Guard --> SQL
    Guard --> Logs
    Guard --> Broker

⚡ Быстрый старт за 3 минуты

1. Клонирование и настройка окружения

git clone https://github.com/Calera-Labs/PROJECT_LITHOS.git
cd PROJECT_LITHOS

# Create and activate virtual environment
python -m venv .venv

# On Linux/macOS:
source .venv/bin/activate

# On Windows (PowerShell):
.\.venv\Scripts\Activate.ps1

# Install dependencies
pip install -r requirements.txt

2. Настройка API-ключей (.env)

Скопируйте шаблон конфигурации:

cp .env.example .env

Отредактируйте .env, указав свои личные учётные данные Bring-Your-Own-Key:

# Google Gemini BYOK (Free API key from https://aistudio.google.com/app/apikey)
GEMINI_API_KEY=YOUR_GEMINI_API_KEY_HERE
GEMINI_MODEL=gemini-3.1-flash-lite
BYOK_PROVIDER=gemini

# Calera Labs ICX Gateway
ICX_BASE_URL=https://icx.api.caleralabs.com/v1
ICX_API_KEY=YOUR_CALERA_ICX_API_KEY_HERE
ICX_SPACE_ID=lithos_market_memory

# Calera Labs FinSec MCP (Set to true to run in local deterministic mode)
FINSEC_MCP_URL=https://finsec.caleralabs.com/mcp
FINSEC_API_KEY=STANDBY_FOR_KEY
FINSEC_STANDBY_MODE=true

# Safe Execution Sandbox
LITHOS_BROKER_ENV=paper

3. Запуск диагностической проверки

Запустите встроенный инструмент проверки системы, чтобы проверить окружение, заполнить базу данных и протестировать подключение:

python verify_setup.py

4. Запуск интерактивного количественного терминала

python chat.py

💡 Динамическое обновление приглашения ввода

CLI терминала динамически проверяет состояние всех трёх подсистем и обновляет приглашение ввода в реальном времени:

🛠️ Полный каталог MCP-инструментов (18 инструментов)

При запуске server.py в качестве MCP-сервера Project LITHOS предоставляет вашему ИИ-агенту 18 инструментов:

1. Calera Labs FinSec (FinanceSec) — аудит SEC-отчётности (7 официальных инструментов)

• query_financial_sec(query, low_tokens, usd_only): Сертифицированный вывод фактов из SEC EDGAR на естественном языке с указанием источника (accession) или безопасный отказ.

• query_sec_metric_exact(company, metric, period): Точный вывод метрики EDGAR для компании + метрики + периода (gross_margin, total_revenue).

• query_sec_sector_peers(sector_or_industry, period, limit): Сертифицированные метрики XBRL по группам отраслевых аналогов, динамически формируемым на основе кодов SIC.

• compute_sec_cagr(company, metric, start_period, end_period): Расчёт совокупного годового темпа роста (CAGR) на основе проверенных фактов из SEC-отчётности с 0% ошибок вычислений.

• lattice_arith_evaluate(op, company, metric, start_period, end_period): Детерминированный алгебраический решатель с нулевой ошибкой (cagr, ratio, multiply, divide, yoy_series).

• valuation_inputs(company, pack, period): Сертифицированный пакет входных данных для оценки SEC (доступно 12 пакетов: segment_mix, equity_screen, quality_of_earnings, returns_screen, leverage_screen, piotroski_f, altman_z_prime, beneish_m_score, dupont_5step, working_capital_efficiency, dcf_valuation_inputs, ev_bridge).

• vln_capabilities_overview(): Полный каталог сертифицированных моделей оценки и алгебраических решателей.

2. Подсистема памяти Calera Labs ICX Infinite Context

• query_icx_infinite_memory(query, session_id): Обоснованные рассуждения в Calera ICX Volumetric Lattice Network (VLN) на базе Google Gemini 3.1 Flash-Lite BYOK.

• sync_market_to_icx_lattice(news_title, text, family): Потоково передаёт срочные новости, стенограммы или документы в решётку A4 без раздувания контекста токенами LLM.

• query_icx_symbolic_ledger(query): Субмиллисекундное ассоциативное восстановление ($<1\text{ms}$) точных числовых инвариантов.

• quote_icx_memory_slot(family, index): Детерминированное Scoped Recall для точного цитирования регистров документа без вывода LLM.

• detect_market_contradictions(): Обнаруживает топологические пустоты $Betti-2$ и расхождения прогнозов (guidance) между поставщиками и конкурентами.

• get_icx_lattice_stats(): Проверяет активные симплициальные узлы, столбцы памяти, кристаллизованные байты и геометрию 4D-многообразия A4.

• reset_icx_session(session_id): Сбрасывает ходы сессии, сохраняя кристаллизованные факты в базовом пространстве решётки.

3. Живые рыночные данные и микроструктура биржевого стакана уровня 2

• get_live_quote(ticker): Цены в реальном времени, дневные диапазоны, объём и VWAP.

• get_order_book_depth(ticker, depth): Рассчитывает лестницы bid/ask, коэффициенты дисбаланса заявок и условия сжатия ликвидности.

4. Локальный аудит базы данных и альфа-бэктестинг

• get_financial_db_schema(): Схемы таблиц и метрики строк в локальных таблицах временных рядов.

• query_financial_db(sql_query): Безопасное изолированное выполнение SQL только для чтения (деструктивные операторы блокируются).

• backtest_alpha_pattern(ticker, min_morning_drop_pct, require_green_close): Проверяет 5-летние дневные/внутридневные данные на предмет разворотов утреннего падения с анализом объёма.

5. Пост-трейд анализ и телеметрия исполнения

• audit_execution_logs(min_latency_ms, ticker_filter): Выявляет ордера с задержкой/проскальзыванием $>50\text{ms}$ и определяет узкие места маршрутизации на биржах.

6. Систематическая ребалансировка и безопасные шлюзы исполнения

• get_portfolio_summary(): Позиции, капитал, денежные средства и веса секторальной экспозиции.

• propose_portfolio_rebalance(macro_rationale, tech_shift_pct, fixed_income_shift_pct): Систематический ребалансировщик на основе правил, который подготавливает ордера с HMAC-токенами.

• execute_broker_order(order_id, confirmation_token): Отправляет сделки только после проверки подтверждающего токена человека.

🕹️ Интерактивные команды терминала

Внутри python chat.py используйте слэш-команды для мгновенных детерминированных операций:

🔌 Подключение к Claude Desktop и Cursor

Подключение к Claude Desktop

Добавьте Project Lithos в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "project-lithos": {
      "command": "python",
      "args": [
        "/ABSOLUTE/PATH/TO/PROJECT_LITHOS/server.py"
      ],
      "env": {
        "PYTHONUNBUFFERED": "1",
        "LITHOS_BROKER_ENV": "paper",
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY",
        "ICX_API_KEY": "YOUR_ICX_KEY",
        "FINSEC_STANDBY_MODE": "true"
      }
    }
  }
}

🧪 Тестирование

Project LITHOS включает в себя комплексные наборы тестов, охватывающие обработчики команд, динамическую координацию статусов, оценочные пакеты и защиту от инъекций в промпты:

# Run all tests
pytest

# Run tests with verbose output
pytest -v

📜 Лицензия и условия пилотного использования

Project LITHOS распространяется по лицензии Calera Labs Source-Available Evaluation & Educational License.

• Бесплатное использование: Вы можете свободно клонировать, изучать, запускать, тестировать и использовать Project LITHOS в пилотных целях для образовательных, исследовательских, академических и внутренних оценочных проектов с вашими собственными моделями AI (BYOK).

• Ограничения лицензии и запрет на коммерческое копирование: Коммерческое распространение, перепродажа или копирование проприетарных интеграционных механизмов для коммерческих SaaS-продуктов без явного письменного разрешения от Calera Labs строго запрещены.

• Полные условия см. в файле LICENSE.

📚 Дополнительная документация

• Руководство по началу работы

• Глубокое погружение в системную архитектуру

• Политика безопасности и ограничения

• Рекомендации по внесению вклада