MCP 服务器

Infinite Context (ICX) MCP Server

Connects AI agents to persistent topological memory on the Volumetric Lattice Network, enabling sub-5ms associative recall and storage of facts, documents, and code.

README

Infinite Context (ICX) — Persistent Memory MCP Server

Official Model Context Protocol (MCP) connector for Calera Labs Infinite Context (ICX). Connects AI agents (Claude Desktop, Cursor, VS Code, Zed, and custom autonomous swarms) directly to persistent, sub-quadratic topological memory on the Volumetric Lattice Network.

"Context Without Limits. Memory Without Loss."

⚡ Why ICX Over Naive 1M+ Context Windows?

Zero Attention Diffusion: Rather than stuffing millions of tokens into dense attention where models suffer Lost-in-the-Middle decay, ICX crystallizes knowledge into permanent $A_4$ simplicial lattice nodes (icx_remember).
Sub-5ms Scoped Recall: Geodesic associative search returns verified factual sentences and verbatim quotes through a compact numbered viewport (icx_recall_scoped).
Benchmark Provenance:
- 96.28% (466/484 exact) on RULER MRCR v2 at 128k context.
- 54.87% (276/503) on LongBench v2 official benchmark.
- 51.98% noise reduction across context viewports.
Streamable Hosted Endpoint: Zero local model downloads required. Connect via streamable HTTP/SSE with your API key from dashboard.caleralabs.com.

🚀 1-Click Quickstart Integrations

1. Cursor IDE

Add the following to your project's .cursor/mcp.json (or global Cursor Settings → Features → MCP):

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

(Get your free API key at dashboard.caleralabs.com)

2. Claude Desktop

Add to your 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 (1-Click Terminal Command)

Install automatically across Claude, Cursor, or VS Code using Smithery:

# 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

Add to .vscode/mcp.json:

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

5. Stdio Gateway Proxy (Air-Gapped / CLI)

If your environment only supports local stdio sub-processes:

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

🛠️ Certified MCP Tools Reference

Tool	Purpose	Primary Inputs	Behavior
`icx_remember`	Stores text, code, decisions, and documentation into persistent long-term memory.	`text` (required), `space_id`, `filename`, `family`	Additive & Non-destructive
`icx_recall_scoped`	Performs semantic search across memory to retrieve grounded facts and source citations for QA.	`query` (required), `space_id`, `top_k`	Read-only
`icx_search_facts`	Keyword and entity search across memory nodes for lexical exploration and token lookup.	`query` (required), `space_id`, `limit`	Read-only
`icx_quote_slot`	Retrieves exact character-for-character verbatim text and SHA-256 hashes from document registers.	`family` (required), `index` (required), `space_id`	Read-only
`icx_inspect_space`	Returns diagnostic telemetry: active nodes, total synapses, grounded facts, and contradiction alarms.	`space_id` (optional)	Read-only
`icx_reset_session`	Clears conversational turn history while preserving all underlying persistent memory.	`space_id` (optional)	Mutates session only

🤖 Recommended Agent System Instruction

To ensure your autonomous agents systematically store architecture decisions and recall ground-truth context, add this block to your agent's system prompt:

Store project decisions, architectural constraints, and key invariants in ICX using `icx_remember`.
Before answering historical codebase questions or resolving complex dependencies, use `icx_recall_scoped` to retrieve exact grounded facts.