HeurChain

为 AI 智能体提供持久化记忆。通过混合关键词和向量搜索,在不同会话间保存和检索决策、偏好及项目上下文。

托管 MCP 服务器

npx add-mcp 'https://api.heurchain.com/mcp/sse'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

HeurChain — AI Memory Infrastructure

Persistent memory for AI agents. Built on Model Context Protocol. Save decisions, preferences, and task context, then retrieve them across sessions through MCP or the HTTP API.


1. Overview

Keep the decisions, preferences, and task context your agents need. HeurChain gives your AI tools a shared place to save useful memory and find it again across sessions.

  • Persistent Memory: Remote MCP over Streamable HTTP for compatible clients, plus a REST API.
  • Hybrid Retrieval: BM25 + dense vector search fused via Reciprocal Rank Fusion (RRF).
  • Tenant Scoped: Isolated access with workspace credentials.
  • Memory Lifetimes: Granular decay tiers (ops, notes, self).

2. Memory Lifetimes & Decay Tiers

Choose a namespace when you save a memory. Its decay policy affects how long it stays active in the working set before moving to the durable vault:

  • ops/ (Fast Decay · HOT): Operational chatter, intermediate task state, scratchpad notes. Cleared or consolidated rapidly.
  • notes/ (Standard Decay · WORKING): Default working memory. Working decisions, conversation summaries, project context.
  • self/ (Slow Decay · COLD/DURABLE): Durable facts about the agent, persistent user preferences, verified procedures, architectural constraints.

3. Connect, Save, and Search

Model Context Protocol (MCP)

Choose Streamable HTTP (sometimes labeled HTTP) and connect to https://api.heurchain.com/mcp/sse. The URL is unchanged; its /sse suffix does not select the transport. For API-key setup send both headers below. Official MCP Registry listing.

{
  "mcpServers": {
    "heurchain": {
      "type": "http",
      "url": "https://api.heurchain.com/mcp/sse",
      "headers": {
        "X-HeurChain-API-Key": "YOUR_API_KEY",
        "X-HeurChain-Tenant": "YOUR_TENANT_ID"
      }
    }
  }
}

OAuth 2.1 authentication is also supported using metadata discovered at https://api.heurchain.com/.well-known/oauth-protected-resource/mcp/sse.

Direct REST API

Store Memory (POST /store)

curl -X POST https://api.heurchain.com/store \
  -H "Content-Type: application/json" \
  -H "X-HeurChain-API-Key: $HEURCHAIN_API_KEY" \
  -H "X-HeurChain-Tenant: $HEURCHAIN_TENANT_ID" \
  -d '{
    "text": "Use UTC for billing timestamps.",
    "agent_id": "my-agent",
    "namespace": "notes",
    "tags": ["decision", "project-context"]
  }'

Search Memory (POST /search)

curl -X POST https://api.heurchain.com/search \
  -H "Content-Type: application/json" \
  -H "X-HeurChain-API-Key: $HEURCHAIN_API_KEY" \
  -H "X-HeurChain-Tenant: $HEURCHAIN_TENANT_ID" \
  -d '{
    "text": "billing timestamps",
    "tags": ["project-context"],
    "limit": 5
  }'

4. Plans & Pricing

  • Public Code (Reference): Explore the public implementation and documented setup requirements on GitHub.
  • Hosted ($5/month): 1 tenant, 1 human seat, unlimited agents within plan limits. 25,000 vectors, 50,000 operations/month, 20 requests/minute, MCP and REST access, Markdown vault export.
  • Enterprise ($49/month): 1 seat included ($9.99/mo per additional seat). 2,000,000 vectors, 5,000,000 operations/month, 600 requests/minute, unlimited agents within plan limits.
  • Enterprise Custom (Contact Sales): Dedicated infrastructure, custom quotas, custom SLAs. Contact sales@heurchain.com.

5. Agent Resources & Discovery