Lorebase
Lets agents read and change a governed, versioned Postgres knowledge graph
- 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-heraldAdd 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:8080RequiredLOREBASE_DOMAINDomain used when a tool call names noneLOREBASE_API_KEYAPI key of the agent's service principal; not needed when Keeper runs with authentication offLOREBASE_URLOrigin of the Keeper REST API as seen from the containerRequiredLOREBASE_DOMAINDomain used when a tool call names noneLOREBASE_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

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP 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

Nautilus Compass Memory
MCP serverLocal-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

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity