Cloudflare Memory MCP

Ein projektspezifischer Memory-MCP-Server für opencode, vollständig auf Cloudflares kostenlosem Tarif gehostet:

• Notizen – einfache schlüsselbasierte Speichereinträge mit Tags und Typen

• Vektor – semantischer Abruf über Vectorize (Embeddings von Workers AI @cf/baai/bge-m3, 1024-dimensional, mehrsprachig)

• Graph – Entitäten + Relationen in D1 (SQLite) mit rekursiver Traversierung

• Web-Dashboard – öffne / in einem Browser, um jedes Projekt mit seinen Memories zu sehen. Jede Projektkarte öffnet eine Detailansicht mit einem interaktiven kraftbasierten Graphen seiner Entitäten und Relationen (Mausrad = Zoomen, Ziehen = Verschieben, Doppelklick oder Buttons = Zurücksetzen, Hover = Nachbarn hervorheben) sowie einen Projekt löschen-Button, der das Projekt, seine Notizen, den Graphen, FTS-Zeilen, Caches und Vektor-Embeddings entfernt

opencode ── MCP (streamable HTTP + Bearer auth) ──> Worker
                                                     ├─ Vectorize   memory-vectors (namespace per project)
                                                     ├─ D1          projects / notes / nodes / edges / FTS5
                                                     ├─ Workers AI  bge-m3 embeddings
                                                     └─ KV          recent-memories cache

Screenshots

Projektliste

Das Dashboard listet jedes dem Konto bekannte Projekt auf, darunter die Anzahl der Notizen, Entitäten, Relationen und der letzten Aktivität.

Wissensgraph

Öffne ein Projekt, um seine Memories und seinen Graphen zu inspizieren. Der Graph unterstützt gekrümmte, gerichtete Kanten, Hervorhebung bei „Hover“, Mausrad-Zoom, Paning per Ziehen und Z urücksetzen.

Related MCP server: MCP Memory

Wie die Ordnerisolierung funktioniert

Der Server führt seine MCP-Sitzungen in einem Durable Object aus (kostenloser Tarif, SQLite-Backend) und heftet jede Nachricht einer Sitzung an genau ein isoliertes Isolate. Die Projektidentität wird in dieser Reihenfolge aufgelöst:

1. project_root-Toolargument (empfohlen) – du übergibst deinen Arbeitsordner an jedes Tool, z. B. remember({ project_root: "D:/Projects/foo", content: ... }). Der Server bildet einen Hash aus einer normalisierten Form des Pfads auf eine stabile Projekt-ID und behält sie für den Rest der Sitzung in Erinnerung, sodass spätere Aufrufe sie weglassen können. Das Tool exist_project existiert, um sie explizit festzulegen.

2. project_id-Toolargument – eine explizite ID (ebenfalls für die Sitzung zwischengespeichert).

3. x-project-root / x-project-id-Header – für Clients, die diese konfigurieren.

4. MCP roots – automatische Ordnererkennung, wenn der Client das unterstützt.

Da die Identität nur ein Hash des normalisierten Pfads ist, führt derselbe Ordner, auch wenn er über einen anderen absoluten Pfad geöffnet wird, weiterhin auf dasselbe Projekt. Jeder Lese- und Schreibvorgang ist auf diese ID beschränkt – Vectorize-Abfragen verwenden einen Namespace pro Projekt, und jede D1-Abfrage filtert nach project_id, sodass zwei Ordner sich niemals gegenseitig sehen können.

Verwendung aus opencode

opencodes offen habe ich mich in Treibsand begeben – das ist nicht gut.

When using the memory MCP tools, pass project_root (your bash cwd) on the first
memory call of the session.

Setup

Voraussetzungen: Node 18+, ein Cloudflare-Konto und ein einmaliges npx wrangler login.

npm install
npm run setup        # creates D1 db, KV namespace, Vectorize index; patches wrangler.toml
npm run db:migrate:remote
npx wrangler secret put MEMORY_AUTH_TOKEN   # optional but strongly recommended
npm run deploy

Deine Endpunkte:

• MCP: https://cloudflare-memory-mcp.<your-subdomain>.workers.dev/mcp

• Dashboard: https://cloudflare-memory-mcp.<your-subdomain>.workers.dev/

Lokale Entwicklung:

npm run dev              # wrangler dev --local  (AI + Vectorize are remote-only)
npm run db:migrate:local

Einbindung in opencode

Ein einziger Eintrag – dieselbe Konfiguration funktioniert in jedem Projekt. Keine projektspezifischen Werte nötig:

// ~/.config/opencode/opencode.jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "memory": {
      "type": "remote",
      "url": "https://cloudflare-memory-mcp.<your-subdomain>.workers.dev/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:MEMORY_AUTH_TOKEN}"
      }
    }
  }
}

Die Projektidentität wird dann vom Agenten selbst bestimmt: sie übergibt ihr Arbeitsverzeichnis als project_root beim ersten Memory-Aufruf jeder Sitzung (siehe den AGENTS.md-Hinweis oben), und der Server bindet von da an alles an diesen Ordner.

Das Dashboard (/) fragt einmal nach demselben MEMORY_AUTH_TOKEN und hört es in localStorage. Wenn du MEMORY_AUTH_TOKEN leer lässt, ist alles öffentlich – das nur für private/wiederverwendbare Experimente sinnvoll.

MCP-Tools

Alle Tools akzeptieren ein optionales project_root (Ordnerpfad oder file://-URI) und project_id; sobald eines von beiden in einer Sitzung angegeben wurde, wird es gespeichert.

Budget für den kostenlosen Tarif

Wenn du einmal an die Vektor-Obergrenze stößt, gibt es Design-Hebel: Bette die nur die dauerhaften Memories ein (remember mit type: "decision" | "fact" ) und überlasse search_memory (FTS5, ungedeckelt) den Long Tail; oder baue den Index mit bge-small (384-dimensional, nur Englisch) neu auf, für die ca. 3-fache Kapazität.

Projektstruktur

src/index.ts      fetch router: dashboard, /api/*, /mcp -> Durable Object
src/session-do.ts MCP session host (Durable Object): sessions, SSE, roots, identity
src/tools.ts      the 10 tool definitions (zod schemas + implementations)
src/store.ts      D1 / Vectorize / KV data layer
src/identity.ts   project-id derivation from folder roots
src/embed.ts      Workers AI bge-m3 embeddings
src/api.ts        dashboard API (projects, detail, graph, delete)
src/web.ts        dashboard page (token-gated)
migrations/       D1 schema
scripts/setup.mjs  creates Cloudflare resources and patches wrangler.toml
AGENTS.md          template to copy into projects that use this memory server