Skip to content
MCP server

Lorebase

Lets agents read and change a governed, versioned Postgres knowledge graph

Runs locallyStatus and history
Pricing
Open source
Platforms
self-hosted, CLI
Runs
Locally
Version
0.4.0
Listing updated
3 days ago

About Lorebase

Lorebase is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Herald is a thin stateless MCP layer over Lorebase's Keeper REST API. Every call goes to Keeper with the agent's own API key, so authorisation, masking, audit and rate limits stay in one place; Herald holds no database credentials and never calls a model. It exposes a small set of typed tools, two resources and one prompt.

Lorebase itself is an open-source ontology platform with git-like branching and three-way merge. Agents get a service principal with only needed grants, for instance a reader role plus one named write operation; the docs say never to give an agent an admin key.

Run it over stdio (one process per agent) or Streamable HTTP (one shared process). It retries after 429 and 503 up to twice and caps tool output at 12,000 characters by default. Install from PyPI or use the Docker compose profile. Licensed Apache-2.0.

Install

Run in a terminal

claude mcp add lorebase-herald --env LOREBASE_URL='<LOREBASE_URL>' --env LOREBASE_API_KEY='<LOREBASE_API_KEY>' -- uvx lorebase-herald

Add to claude_desktop_config.json

{
  "mcpServers": {
    "lorebase-herald": {
      "command": "uvx",
      "args": [
        "lorebase-herald"
      ],
      "env": {
        "LOREBASE_URL": "<LOREBASE_URL>",
        "LOREBASE_API_KEY": "<LOREBASE_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "lorebase-herald": {
      "command": "uvx",
      "args": [
        "lorebase-herald"
      ],
      "env": {
        "LOREBASE_URL": "<LOREBASE_URL>",
        "LOREBASE_API_KEY": "<LOREBASE_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "lorebase-herald": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "lorebase-herald"
      ],
      "env": {
        "LOREBASE_URL": "<LOREBASE_URL>",
        "LOREBASE_API_KEY": "<LOREBASE_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "lorebase-herald": {
      "command": "uvx",
      "args": [
        "lorebase-herald"
      ],
      "env": {
        "LOREBASE_URL": "<LOREBASE_URL>",
        "LOREBASE_API_KEY": "<LOREBASE_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "lorebase-herald": {
      "command": "uvx",
      "args": [
        "lorebase-herald"
      ],
      "env": {
        "LOREBASE_URL": "<LOREBASE_URL>",
        "LOREBASE_API_KEY": "<LOREBASE_API_KEY>"
      }
    }
  }
}

Configuration

  • LOREBASE_URLOrigin of the Keeper REST API, for example http://127.0.0.1:8080Required
  • LOREBASE_DOMAINDomain used when a tool call names none
  • LOREBASE_API_KEYAPI key of the agent's service principal; not needed when Keeper runs with authentication off
  • LOREBASE_URLOrigin of the Keeper REST API as seen from the containerRequired
  • LOREBASE_DOMAINDomain used when a tool call names none
  • LOREBASE_API_KEYAPI key of the agent's service principal; not needed when Keeper runs with authentication off

What it does

Per-agent keys
Calls carry the agent's own API key.
Governed writes
Writes limited to named operations.
Two transports
stdio or Streamable HTTP.
Output cap
12,000 characters by default.
Retries
Resends after 429 or 503.

Good for

  • Let an agent read a supply-chain graph
  • Allow one controlled write
  • Share one Herald among agents
  • Audit agent graph access

Pricing

Open source

Apache-2.0

Prices change. Check aantenore.github.io before you buy.

Lorebase FAQ

What does it need?

A running Keeper and LOREBASE_URL.

Does it hold DB credentials?

No.

Licence?

Apache-2.0.

How should keys be scoped?

Service principal with minimal grants.

Is Lorebase free?

Yes. Lorebase is open source, so you can use and self-host it for free.

How do I add Lorebase to Claude Code?

Run this command in your terminal: claude mcp add lorebase-herald --env LOREBASE_URL='<LOREBASE_URL>' --env LOREBASE_API_KEY='<LOREBASE_API_KEY>' -- uvx lorebase-herald

What are the best alternatives to Lorebase?

The closest alternatives to Lorebase are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and Midplane.

Alternatives to Lorebase

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  5. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  6. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity