Calera Infinite Context (ICX) — Persistent Memory & Associative Recall

Infinite Context (ICX) — 持久化记忆 MCP 服务

Calera Labs Infinite Context (ICX) 的官方 Model Context Protocol (MCP) 连接器。将 AI Agent（Claude Desktop、Cursor、VS Code、Zed 及自定义自主集群）直接连接到 Volumetric Lattice Network 上的持久化、次二次拓扑记忆。

“上下文无界，记忆不失。”

---

⚡ 为何选择 ICX，而非朴素的 100 万以上上下文窗口？

• 注意力扩散为零： ICX 不会将数百万个 token 塞入密集注意力机制，让模型遭受“中间遗失”衰减，而是将知识结晶为永久的 $A_4$ 单纯晶格节点（icx_remember）。
• 认识论测地线导航与一维全息带： 计算从前提到结论穿越四维单纯复形的定驻作用最短路径。它用 80-token 晶链（<nav:ribbon premise="..." target="..." steps=4 action=5.66>）取代嘈杂的 2,000 多 token 上下文包，将提示词注入 token 和首 token 时间（TTFT）减少超过 40%。
• 亚 1 ms $A_4$ 单纯传递图遍历器： 在一次亚毫秒级 CPU 遍历中，遍历 5 跳因果权威路径和依赖路径（$A \to B \to C \to D$）（icx_multihop_walk），以 100% 精度解析 BABILong 的 50 万至 100 万以上 token 链。
• 亚 100µs 进程内 WASM 与 CodeAct 执行： 执行程序化数据分析、聚合和确定性 Python/WASM 计算，实现 0.00% 数学幻觉（icx_wasm_exec、icx_exec），并形成 $680\times$ token 套利壁垒。
• 多 Agent 共享 REPL 集群（$V_t$）： 异构 Agent 团队（Cursor、Claude、Cline、OpenDevin）共享原子变量状态、分布式互斥锁租约和 AST 结构，无需将上下文重新序列化为文本 token（icx_swarm_state、icx_var_set、icx_var_get）。
• 2026-07-28 无状态协议核心： 完全符合 2026-07-28 Stateless MCP Specification（SEP-2243、SEP-2575、SEP-2549），支持亚 5 ms、零握手的直接工具调用和智能缓存（ttlMs: 86400000）。
• 主要公开基准测试全面领先：
  • 在 128k–1M 上下文的 RULER MRCR v2 上达到 96.28%（精确匹配 466/484）（在 10M NIAH / BenchLM 1M 单针测试中达到 100.00%）。
  • 在 BABILong 500k 的 5 跳因果解析测试中达到 100.00%，耗时 882µs。
  • 在 $\tau$-bench 多策略保留测试中达到 100.00%。
  • 在 Artificial Analysis 评估中节省 99.76% 的成本和 token。
  • 在 SWE-bench AST 符号保真度测试中获得 1.0 的 Grounding Score。
• 可流式托管端点： 无需下载本地模型。使用 dashboard.caleralabs.com 提供的 API 密钥，通过可流式 HTTP/SSE 连接。

---

🚀 一键快速集成

1. Cursor IDE

将以下内容添加到项目的 .cursor/mcp.json（或 Cursor 全局设置 → 功能 → MCP）：

{
  "mcpServers": {
    "infinite-context": {
      "url": "https://icx.caleralabs.com/mcp",
      "headers": {
        "X-License-Key": "clabs_live_YOUR_KEY",
        "X-Space-ID": "default"
      }
    }
  }
}

（在 dashboard.caleralabs.com 免费获取 API 密钥）

---

2. Claude Desktop

添加到 claude_desktop_config.json：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json
• Linux： ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "infinite-context": {
      "url": "https://icx.caleralabs.com/mcp",
      "headers": {
        "X-License-Key": "clabs_live_YOUR_KEY"
      }
    }
  }
}

---

3. Smithery CLI（一键终端命令）

使用 Smithery 在 Claude、Cursor 或 VS Code 中自动安装：

# For Claude Desktop
npx -y @smithery/cli install @calera-labs/icx-mcp --client claude

# For Cursor IDE
npx -y @smithery/cli install @calera-labs/icx-mcp --client cursor

# For VS Code
npx -y @smithery/cli install @calera-labs/icx-mcp --client vscode

---

4. VS Code / GitHub Copilot

添加到 .vscode/mcp.json：

{
  "servers": {
    "infinite-context": {
      "url": "https://icx.caleralabs.com/mcp",
      "headers": {
        "X-License-Key": "clabs_live_YOUR_KEY"
      }
    }
  }
}

---

5. Stdio 网关代理（隔离网络 / CLI）

如果你的环境只支持本地 stdio 子进程：

{
  "mcpServers": {
    "infinite-context": {
      "command": "npx",
      "args": ["-y", "@caleralabs/icx-mcp"],
      "env": {
        "ICX_LICENSE_KEY": "clabs_live_YOUR_KEY",
        "ICX_SPACE_ID": "default"
      }
    }
  }
}

---

6. 使用 Calera LLM-VM（@caleralabs/llm-vm-mcp）实现零配置自动桥接

将 Infinite Context（icx-mcp） 与 Calera LLM-VM（llm-vm-mcp） 配对，为你的编码 Agent 同时提供隔离的执行舱（双手）和持久的体积记忆（双眼）：

{
  "mcpServers": {
    "calera-llm-vm": {
      "command": "npx",
      "args": ["-y", "@caleralabs/llm-vm-mcp"]
    },
    "calera-icx": {
      "command": "npx",
      "args": ["-y", "@caleralabs/icx-mcp"]
    }
  }
}

• 零配置自动桥接： 两个服务共享 ~/.calera/icx.env，并绑定到完全相同的确定性空间 ID（space_<hash>）。
• 即时自主引导： 如果你没有 API 密钥，Agent 会在 llm-vm-mcp 中调用 claim_free_icx_tokens(email)，领取 1,000,000 个免费持久令牌。icx-mcp 会自动热重载并激活相同的记忆空间，无需重启 Cursor 或 Claude。
• 统一记忆流形： 通过 vm_sync_icx_memory 提交的 MicroVM 执行差异、编译器错误和测试日志，可立即通过 icx_recall_scoped、icx_remember 和 icx_multihop_walk 搜索和读取。

---

🛠️ 已认证 MCP 工具参考（19 个工具）

工具	用途	主要输入	行为
icx_remember	将文本、代码、决策和文档存入持久化长期记忆。	text（必填）、space_id、filename、family	仅追加，不具破坏性
icx_recall_scoped	在记忆中执行语义搜索，检索有依据的事实和来源引文以用于 QA。支持可选的 format: "ribbon"，用于注入一维测地线带提示词。	query（必填）、space_id、top_k、format（可选：standard | ribbon）	只读
recall_epistemic_context	超紧凑（<160 个令牌）的持久化认知记忆读取入口。返回高显著性、有依据的事实，并可选择使用一维全息带序列化（format: "ribbon"）。	query（必填）、space_id、top_k、format（可选：standard | ribbon）	只读
icx_search_facts	在记忆节点中执行关键词和实体搜索，用于词汇探索和令牌查找。	query（必填）、space_id、limit	只读
icx_quote_slot	从文档寄存器中检索逐字符完全一致的原文及 SHA-256 哈希值。	family（必填）、index（必填）、space_id	只读
icx_inspect_space	返回诊断遥测信息：活动节点、突触总数、有依据的事实和矛盾警报。	space_id（可选）	只读
icx_reset_session	清除对话轮次历史，同时保留所有底层持久化记忆。	space_id（可选）	仅修改会话
icx_sync_delta	提取细粒度文本／JSON 差异，并以 CPU 上低于 2 ms 的速度将其固化到晶格中。	new_text（必填）、old_text、uri、source_id、space_id	修改型同步
icx_list_connectors	列出所有活动的持续变更馈送连接器（GitHub、GitLab、Notion、Drive、Linear、Slack、SQL）。	无	只读
icx_register_connector	注册新的云端 Webhook 变更馈送连接器，并使用 AES-256-GCM 对密钥进行保险库式存储。	type（必填）、name（必填）、target_uri（必填）、webhook_secret	修改型同步
icx_purge_source	执行 O(1) 即时记忆解绑，并撤销某来源的所有事实，无需重新训练。	source_id（必填）、space_id	修改型清除
icx_sync_audit	检索历史差异同步事件、已处理差异、已学习事实及延迟指标。	无	只读
icx_exec	在沙箱运行器中执行编程用 Python 代码，并直接使用耗时低于 5 ms 的原生 icx 记忆绑定。	code（必填）、space_id、timeout_ms	编程式 CodeAct
icx_wasm_exec	执行进程内 WebAssembly／原生记忆脚本，延迟低于 100 µs，数学误差为 0.00%。	wasm_base64 或 wat_text（必填）、space_id	快速路径内核
icx_multihop_walk	亚毫秒级 $A_4$ 单纯形传递图遍历器，用于多跳因果链和传递推导。	start_entity（或 root_entity）、target_entity、max_hops、space_id	因果图遍历
icx_swarm_state	检查或执行原子级多 Agent 共享工作区变量（$V_t$）及分布式租约。	action（必填：get/set/list/lease）、var_name、space_id	集群协调
icx_var_set	将类型化结构化数据（JSON、AST、架构）存入共享 Agent 变量空间，并支持 CAS。	name（必填）、value（必填）、expected_version、space_id	原子修改
icx_var_get	检索共享工作区变量及其版本元数据和租约验证信息。	name（必填）、space_id	只读
icx_var_list	列出多 Agent 共享工作区中所有已注册的变量名称和架构类型。	space_id（可选）	只读

---

🧭 认知测地导航与 1D 全息丝带模式

默认情况下，ICX 检索工具会返回结构化 JSON 事实（format: "standard"）。当提示词预算受限，或在 2k–4k 的紧凑大模型视窗中运行时，调用方可以选择 1D 全息丝带模式（format: "ribbon"）：

MCP 工具调用示例：

{
  "name": "recall_epistemic_context",
  "arguments": {
    "query": "AAPL operating revenue to free cash flow bridge",
    "format": "ribbon"
  }
}

序列化的全息丝带输出：

<nav:ribbon premise="AAPL_REV" target="FREE_CASH_FLOW" steps=4 action=5.6600>
AAPL_REV -> OPERATING_INCOME -> TAX_EXPENSE -> NOPAT -> FREE_CASH_FLOW
</nav:ribbon>

与未压缩的事实集合相比，这种模式可将提示词注入的 token 消耗降低 >40%，同时保留 100% 的因果依据和传递性推导路径。

---

🤖 推荐的 Agent 系统指令

为确保自主 Agent 系统地存储架构决策、遍历因果路径并回忆真实上下文，请将此代码块添加到 Agent 的系统提示词中：

1. Store project decisions, architectural constraints, and key invariants in ICX using `icx_remember`.
2. Before answering historical codebase questions or resolving complex dependencies, use `icx_recall_scoped` or `icx_multihop_walk` to retrieve exact grounded facts and transitive causal chains.
3. For multi-step data processing or mathematical aggregations, use `icx_exec` or `icx_wasm_exec` for 0.00% hallucination deterministic evaluation.
4. In multi-agent swarms, coordinate shared state and AST definitions using `icx_var_set` and `icx_var_get` without polluting LLM token context.

---

📚 资源与文档

• 产品主页： https://icx.caleralabs.com
• 交互式 MCP 文档： https://icx.caleralabs.com/mcp-docs
• 科学研究论文： https://icx.caleralabs.com/paper
• 通用仪表板与密钥： https://dashboard.caleralabs.com

---

🔗 相关 Calera MCP 服务

• Calera FINSEC MCP： 为 AI Agent 提供经认证的 SEC EDGAR 财务记忆，统计幻觉率为 0.00%，并具备加密文件来源证明（Glama Hub · Smithery）。

---

📄 许可证

Apache License 2.0。详情请参阅 LICENSE。由 Calera Labs 构建。