🪨 PROJECT LITHOS

기관용 퀀트 인텔리전스, Calera FinSec SEC 감사 & Model Context Protocol (MCP) 기반 일반 LLM용 ICX Infinite Context 아키텍처

"고속 시장을 위한 흔들림 없는 확실한 진실 — Project Lithos는 현대 퀀트 AI를 지탱하는 견고하고 결정론적인 기반암입니다."

🌋 프로젝트 내력과 바이브 코딩의 기원

Project Lithos는 Calera Labs ICX Infinite Context API와 Calera Labs FinSec (FinanceSec) MCP Server를 위한 오픈 교육용 참조 테스트 데이터와 파일럿 테스트베드로, Live Stream Vibe Coding 세션 중에 만들어졌습니다.

지질학에서 **암석권(Lithosphere)**은 흔들리지 않는 지구의 지각이자 기반암입니다.

금융 퀀트 엔지니어링에서 상업용 추론 LLM(Google Gemini 3.1 Flash-Lite, Claude 3.5 Sonnet, GPT-4o)을 고속 시장 데이터 및 거래 인프라와 결합하려면 **결정론적 확실성(ground truth)**과 환각 제로가 필요합니다.

1. 결정론적 SEC 서류 출처 검증 (Calera FinSec MCP — 다국적 기업 수준의 $<2\text{ms}$ GAAP 추출, covenants(약정), 부문 구성(segment mix), 계산 오류 0%)

2. 무한 컨텍스트 메모리 및 실시간 델타 동기화 (Calera ICX A4 Lattice — $<1\text{ms}$ 서브 밀리초 연상 리콜, 토큰 팽창 0)

3. Level-2 주문장 데이터 및 스퀴즈 엔진 (실시간 호가 사다리, 주문 불균형 비율, 유동성 스퀴즈 감지)

4. HFT 사후 거래 원격 측정 감사 (경로 병목 지점, TCP 재전송, $>50%$ 밀리초 지연 슬리피지 정밀 탐지)

5. 위상 수학 기반 모순 탐지 (공급업체 경고와 기업 가이던스 사이의 $Betti-2$ 전단 공백)

6. 로컬 5년 SQL 알파 백테스트 (하락 후 반등 패턴, 거래량 누적 이상 감지)

7. 암호화 보호된 브로커 실행 (사람 개입 HMAC 토큰 + 프롬프트 인젝션 쉴드)

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는 AI 에이전트에 18개의 도구를 노출합니다:

1. Calera Labs FinSec (FinanceSec) SEC 서류 감사 (공식 도구 7종)

• query_financial_sec(query, low_tokens, usd_only): 인증된 자연어 SEC EDGRAR 팩트 검색 — 접수 출처(accession provenance) 또는 안전한 거절.

• query_sec_metric_exact(company, metric, period): 회사+지표+기간에 대한 EDHKAR 사실 기반 정확 미터표(gross_margin, total_revenue).

• query_sec_sector_peers(sector_or_industry, period, limit): SIC 코드 기반으로 동구축된 업계피어 그룹의 인증XBRL 지표.

• compute_sec_cagr(company, metric, start_period, end_period): 검증된 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, vcf_valuation_inputs, ev_bridge).

• vln_capabilities_overview(): 인증 밸류 및 산술 연산 솔루션의 전체 카탈로그.

2. Calera Labs ICX Infinite Context 저장소

• query_icx_infinite_memory(query, session_id): Google Gemini 3.1 Flash-Lite BYOK 기반의 Calera ICX VLN(Volumetric Lattice Network) 상에서 근거 추론.

• sync_market_to_icx_lattice(news_title, text, family): 속보, 회의록, 또는 보고서를 A4 격자구로 스트리밍하여 컨텍스트 숫자가 늘지 않게.

• query_icx_symbolic_ledger(query): 정확한 수치 불변값에 대한 서브 밀리초 연상 리콜 ($<1\text{ms}$). ** quote_icx_memory_slot(family, index)**: LLM 없는 상태에서 정확한 문서 레지스터를 인용하는 결정론적 스코프 리콜.

• detect_market_contradictions(): 공급업체와 경쟁사 사이의 논리적 갭 및 가이던스 변동을 $Betti-2$ 기하윈도로 감지.

• get_icx_lattice_stats(): 현재 심플리셜(simplicial) 노드, 메모리 열, 결정화된 바이트 및 4D A4 매니폴드 지오메트리를 검사.

• reset_icx_session(session_id): 최하부 격자 공간의 결정화된 사실은 유지하면서 대화 턴을 재설정.

3. 실시간 마켓 데이터 및 Level-2 오더북 미시구조

• get_live_quote(ticker): 실시간 가격, 당일 범위, 거래량, VWAP.

• get_order_book_depth(ticker, depth): 매수/매도 호가 사다리, 주문 불량 비율 및 유동성 스키즈 독징 연산.

4. 로컬 데이터베이스 감사 및 알파 백테스트

• get_financial_db_schema(): 로컬 시계열 테이블의 스키마 및 메트릭 수.

• query_financial_db(sql_query): 안전하고 샌드박스된 읽기 전용 SQL 실행(파괴문 거부).

• backtest_alpha_pattern(ticker, min_morning_drop_pct, bad_close): 5년치 데일리/인트라데이 데이터에서 거래량 볼룸(바큡)을 포함한 강세 반전 패턴 검사.

5. 거래 후 분석 및 실행 성능 기록 감사

• audit_execution_orders(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): 확인 토큰이 검증되면 트레이드 실행.

30. 🔲 인터랙티브 터미널 명령어

python chat.py 넣고 SLASH 명령으로 즉시 결정적 동작을 실행할 수 있습니다:

명령어 | Syntax 예시 | 설명

| :------------------ | :------------------------------------------ | :----------------------------------------------------- | | /sec | /sec NVDA gross margin FY2026 | SEC EDGBAR에 대한 단락 출처가 있는 사실 조회 | | /pack | /pack NVDA segment_mix | 12개 인증 밸류에이션 패키 중 하나 추출 | | /metric | /metric NVDA gross_margin | 정확한 EDGBAR XBRL 컨셉 리콜 | | /cagr | /cagr NVDA revenue FY2022 FY2025 | 오류 없이 CAGR 계산 | | /eval | /eval cagr NVDA revenue FY2022 FY2025 | 결정론적 제로 오류 대수학 연산 | | /peers | /peers semiconductors 5 | SIC 업계 피어 그룹의 XBRL 지표 | | /overview | /overview | 인증된 FinSec 밸류 팩 전체 개요 | | /backtest | /backtest AAPL -3.0 | 5년 동안의 아침 하락 반전 알파백 테스트 | | /book | /book NVDA 10 | 2레벨 오더북 깊이 분석 및 유동성 스윕 감지 | | /logs | /logs 50.0 | 슬리피 > 50ms 로그 감사 | | **/ 체인지 | /ingest TSMC lead times extended to 22 weeks | 뉴스/트랜스크립트를 Calera A4 lattice에 흡수 | | /quote | /quote supply_chain.semiconductors 0 | LLM 추론없이 정확한 메모리 슬롯 인용 | | /stats | /stats | ICX A4 Lattice의 simplex 노드 및 메모리 바이트 표시 | | /contradictions | /contradictions | $Betti_2$ 기반 가이던스 층 사이를 감지 | | /portfolio | /portfolio | 현재 포트폴리오, 주식가치, 현금 및 섹터비중 조회 | | /rebalance | /rebalance Trim tech by 5% | HMAC 토큰과 함께 시스템 매크로 리밸런스 제안 | | /execute | /execute LITHOS-STG-XXXX TOKEN | 사람 승인 토큰을 확인 후 매도/매수 주문 실행 | | /model | /model claude-3-5-sonnet anthropic KEY | 활성 LLM 추론 모델 변경 | | /toggle | /toggle llm or /toggle icx | ICX/Gemini/하위 시스템 켜기/끄기 | | /status | /status | 하위 시스템 진단/실시간 대기 상세 | | /reset | /reset | lattice 팩트는 유지하면서 세션 재설정 | | /help | /help | 도움말 매트릭스 표시 | | /트레이드 | /exit 또는 /quit | 터미널 연결 종료 |

🔌 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에 따라 라이선스가 부여됩니다.

• 무료 사용: 교육, 연구, 학술 및 내부 파일럿 평가 목적으로 자체 BYOK AI 모델과 함께 Project LITHOS를 복제, 연구, 실행, 테스트 및 파일럿 운영할 수 있습니다.

• 라이선스 제한 및 상업적 복사 금지: Calera Labs의 명시적 서면 허가 없이 상업적 재배포, 재판매, 또는 상업용 SaaS 제품을 위한 독점 통합 하네스 복사는 엄격히 금지됩니다.

• 전체 세부 사항은 LICENSE 파일을 참조하십시오.

📚 추가 문서

• 시작 가이드

• 시스템 아키텍처 심층 분석

• 보안 정책 및 가드레일

• 기여 지침