Skip to main content
Glama
deenesjakoruzh
Calera-Labs

project-lithos

by Calera-Labs
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

🪨 项目 LITHOS

机构级量化智能，Calera FinSec SEC 审计与面向通用 LLM 的 ICX 无限上下文架构（基于模型上下文协议 MCP）

Python 3.10+ Model Context Protocol Google Gemini BYOK Calera ICX Calera FinSec License: Educational Pilot

"高速市场不可动摇的基准真相：Project Lithos 是现代量化 AI 之下坚实、确定性的基岩。"

🌋 项目背景与 Vibe Coding 起源

Project Lithos 诞生于 Live Stream Vibe Coding Stream，作为 Calera Labs ICX 无限上下文 API 与 Calera Labs FinSec（FinanceSec）MCP 服务器 的开放教育参考框架和试点测试平台。

在地质学中，岩石圈（Lithosphere） 是地球不可动摇的外层地壳与基岩。

在金融量化工程中，将商业推理 LLM（Google Gemini 3.1 Flash-Lite、Claude 3.5 Sonnet 或 GPT-4o）与高速市场数据和交易基础设施相结合，需要确定性基准真相与零幻觉：

  1. 确定性 SEC 文件溯源（Calera FinSec MCP — 企业级速度 $<2\text{ms}$ GAAP 提取、契约条款、分部构成，0% 计算误差）。

  2. 无限上下文记忆与实时增量同步（Calera ICX A4 Lattice — 亚毫秒关联召回 $<1\text{ms}$，零 token 膨胀）。

  3. Level-2 订单簿深度与挤压引擎（实时买卖盘阶梯、订单失衡比率、流动性挤压检测）。

  4. HFT 交易后遥测审计（精确定位路由瓶颈、TCP 重传以及 $>50\text{ms}$ 延迟滑点）。

  5. 拓扑矛盾检测（供应商预警与公司指引之间的 $Betti-2$ 剪切空洞）。

  6. 本地 5 年 SQL Alpha 回测（低开反弹模式、成交量累积异常）。

  7. 密码学保护的经纪商执行（人在回路 HMAC token + 提示注入防护盾）。

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

使用您个人的自带密钥（BYOK）凭据编辑 .env：

# 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 会动态检查所有三个底层系统的健康状况，并实时更新提示符：

提示符显示

含义 / 活动底层系统

LITHOS [ICX+Gemini] ❯

全部 3 个底层系统健康：Calera FinSec 已激活（以方括号 [ ] 表示）、Calera ICX 已激活、Gemini BYOK 推理已激活。

LITHOS [ICX] ❯

Gemini 宕机/未配置：查询通过 A4 lattice 上的 零 LLM 直接 ICX 记忆召回 无缝执行。

LITHOS ICX+Gemini ❯

FinSec 离线：ICX 和 Gemini 已激活，方括号省略。

LITHOS [Gemini] ❯

ICX 离线：FinSec 和 Gemini 已激活。

LITHOS OFFLINE ❯

全部离线：以本地回退模式运行。

🛠️ 完整 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 EDGAR 事实召回，附带文件来源或安全拒绝。

  • query_sec_metric_exact(company, metric, period)：针对公司 + 指标 + 期间（gross_margin、total_revenue）的精确 EDGAR 指标召回。

  • 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、dcf_valuation_inputs、ev_bridge）。

  • vln_capabilities_overview()：认证估值模型与代数求解器的完整目录。

2. Calera Labs ICX 无限上下文记忆底层系统

  • query_icx_infinite_memory(query, session_id)：基于 Google Gemini 3.1 Flash-Lite BYOK 驱动的 Calera ICX 体积晶格网络（VLN）进行有据推理。

  • sync_market_to_icx_lattice(news_title, text, family)：将突发新闻、文字记录或文件流式写入 A4 lattice，不产生 LLM 上下文 token 膨胀。

  • query_icx_symbolic_ledger(query)：精确数值不变量的亚毫秒关联召回（$<1\text{ms}$）。

  • quote_icx_memory_slot(family, index)：确定性作用域召回，以零 LLM 推理引用精确文档寄存器。

  • detect_market_contradictions()：检测供应商与竞争对手之间的 $Betti-2$ 拓扑空洞与指引分歧。

  • get_icx_lattice_stats()：检查活跃单纯形节点、记忆列、结晶字节以及 4D A4 流形几何。

  • reset_icx_session(session_id)：重置对话轮次，同时保留底层晶格空间中的结晶事实。

3. 实时市场数据与 Level-2 订单簿微观结构

  • get_live_quote(ticker)：实时价格、日内区间、成交量与 VWAP。

  • get_order_book_depth(ticker, depth)：计算买卖盘阶梯、订单失衡比率与流动性挤压条件。

4. 本地数据库审计与 Alpha 回测

  • 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 token 分阶段下达订单。

  • execute_broker_order(order_id, confirmation_token)：仅在验证人工确认 token 后发送交易。

🕹️ 交互式终端命令

在 python chat.py 中，使用斜杠命令进行即时确定性操作：

命令

语法示例

描述

/sec

/sec NVDA gross margin FY2026

查询经认证的 SEC EDGAR 事实，附带段落来源

/pack

/pack NVDA segment_mix

提取 12 个认证估值输入包之一

/metric

/metric NVDA gross_margin

查询精确 EDGAR XBRL 概念召回

/cagr

/cagr NVDA revenue FY2022 FY2025

零误差复合年增长率计算

/eval

/eval cagr NVDA revenue FY2022 FY2025

确定性零误差代数求值

/peers

/peers semiconductors 5

跨动态 SIC 行业同行的 XBRL 指标

/overview

/overview

所有认证 FinSec 估值包概览

/backtest

/backtest AAPL -3.0

5 年 SQL Alpha 回测，用于早盘低开反转

/book

/book NVDA 10

Level-2 订单簿深度与流动性挤压检测器

/logs

/logs 50.0

审计 HFT 执行日志，查找 $>50\text{ms}$ 滑点

/ingest

/ingest TSMC lead times extended to 22 weeks

将突发新闻摄入 Calera ICX A4 Lattice

/quote

/quote supply_chain.semiconductors 0

以零 LLM 推理引用精确文档槽位

/stats

/stats

检查 ICX A4 lattice 单纯形节点与记忆字节

/contradictions

/contradictions

检测 $Betti-2$ 拓扑指引空洞

/portfolio

/portfolio

检查当前投资组合权益、现金与行业权重

/rebalance

/rebalance Trim tech by 5%

以 HMAC token 分阶段执行系统性宏观再平衡

/execute

/execute LITHOS-STG-XXXX TOKEN

以人工确认 token 执行已分阶段订单

/model

/model claude-3-7-sonnet anthropic KEY

动态切换活跃 LLM 推理模型

/toggle

/toggle llm 或 /toggle icx

动态开启或关闭子系统

/status

/status

完整子系统诊断与延迟指标

/reset

/reset

清除会话轮次，同时保留晶格事实

/help

/help

显示命令帮助矩阵

/exit

/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 源代码可用评估与教育许可证 授权。

  • 免费使用：您可以出于教育、研究、学术和内部试点评估目的，使用您自己的 BYOK AI 模型自由克隆、学习、运行、测试和试点 Project LITHOS。

  • 许可证受限且禁止商业复制：未经 Calera Labs 明确书面许可，禁止将专有集成框架进行商业再分发、转售或复制到商业 SaaS 产品中。

  • 请参阅完整的 LICENSE 文件以了解全部细节。

📚 其他文档

This server cannot be installed

F
license - not found
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • SigmaPilot MCP Server by SigmaPilotAI

    SigmaPilot MCP Serverofficial

    SigmaPilotAI
    F
    license
    Not graded
    quality
    A
    maintenance
    A remote Model Context Protocol (MCP) server for real-time cryptocurrency and stock market analysis. Provides AI-powered market intelligence tools with 9 theory-based analysis engines, multi-chain DEX discovery, and enterprise features.

  • QuantGuard MCP

    siddhrrth
    A
    license
    Not graded
    quality
    B
    maintenance
    QuantGuard MCP is a Model Context Protocol server for institutional trading desks to continuously monitor market microstructure and assess trading safety via multiple specialist agents, generating deterministic risk decisions explained in natural language.
    98
    1
    ISC

View all related MCP servers

Related MCP Connectors

  • ko-mcp

    Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.

  • Backtest360

    MCP server exposing the Backtest360 engine API as tools for AI agents.

  • mcp

    MCP server connecting AI agents to non-custodial staking data across 130+ networks.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Calera-Labs/project-lithos'

If you have feedback or need assistance with the MCP directory API, please join our Discord server