CF Memory Plugin

Persistenter Speicher für KI-Agenten, unterstützt durch Cloudflare Agent Memory.

Dieses Plugin ist ein schlanker Client. Cloudflare speichert, klassifiziert und ruft Erinnerungen ab. Sie betreiben keine Vektor-DB, keine Embeddings-Pipeline und keinen Worker.

Private Beta. Bezahlte Workers sind erforderlich. Bezahlte Workers allein reichen nicht — Sie benötigen zusätzlich die Agent-Memory-Berechtigung.

Einrichtung in 60 Sekunden

pip install git+https://github.com/hansakoch/cf-memory-plugin.git

export MCP_CLOUDFLARE_API_KEY="cf-api-token-with-agent-memory"
export CF_ACCOUNT_ID="your-32-char-account-id"

cf-memory test

CF_ACCOUNT_ID ist erforderlich. Es gibt kein Standardkonto. Sie finden sie in der Seitenleiste des Cloudflare-Dashboards.

Erstellen Sie das Token unter dash.cloudflare.com/profile/api-tokens mit ausschließlich der Berechtigung Agent Memory. Verwenden Sie keinen Global API Key erneut.

Related MCP server: agentram-mcp

Was das ist

Kosten

Empfehlung: Workers Paid auf dem Konto, das den Speicher beherbergen soll. Legen Sie Produktionsspeicher nicht auf ein kostenloses Konto. Gehen Sie nicht davon aus, dass jedes bezahlte Workers-Konto Agent Memory hat — wir haben verifiziert, dass bezahlt ≠ Berechtigung bedeutet.

Nach der Beta behandeln Sie Agent Memory als separate Rechnung. Cloudflare hat noch keine GA-Preise veröffentlicht.

Abhängigkeiten

Laufzeit:

Optional:

Für dieses Plugin sind keine Cloudflare Worker, Wrangler, D1, Vectorize oder Workers-AI-Bindungen erforderlich. Das sind Cloudflare-Produkte, die dieser Client nicht verwendet.

Sicherheit

Befolgen Sie die Token-Regeln von Cloudflare: Best Practices für API-Tokens.

• Speichern Sie MCP_CLOUDFLARE_API_KEY in der Umgebung oder in einem Secret-Store. Committen Sie ihn niemals.

• Beschränken Sie das Token auf Agent Memory auf einem Konto.

• Setzen Sie CF_ACCOUNT_ID selbst. Dieses Plugin fällt nicht auf ein anderes Konto zurück.

• cf-memory a2a bindet standardmäßig an 127.0.0.1. Setzen Sie es ohne Authentifizierung nicht dem öffentlichen Internet aus.

• ingest und sync_turn senden Gesprächstext an Cloudflare. Nehmen Sie keine Geheimnisse, Passwörter oder Kundendaten (PII) auf, die Sie nicht speichern dürfen.

• Verwenden Sie einen Namespace pro App und ein Profil pro Benutzer/Mandant.

• Rotieren Sie das Token über die Seite API-Tokens, falls es leakt.

Siehe SECURITY.md.

Aus einem Agenten verwenden

Überall derselbe MCP-Block. Nur der Pfad zur Konfigurationsdatei ändert sich.

{
  "mcpServers": {
    "cf-memory": {
      "command": "cf-memory",
      "args": ["serve"],
      "env": {
        "MCP_CLOUDFLARE_API_KEY": "your-token",
        "CF_ACCOUNT_ID": "your-account-id"
      }
    }
  }
}

Hermes ist der einzige native Anbieter. Er lädt im Hintergrund vor, sodass recall nicht ~5s zu jeder Runde hinzufügt.

hermes config set memory.provider cloudflare-memory
hermes cloudflare-memory test

Python:

import asyncio
from cloudflare_memory import CloudflareMemoryClient

async def main():
    async with CloudflareMemoryClient(
        account_id="your-account-id",
        api_token="your-token",
        namespace="my-app",
        profile="default",
    ) as client:
        await client.remember("User prefers concise answers.")
        result = await client.recall("How should I answer?")
        print(result.answer)

asyncio.run(main())

CLI

cf-memory test                          # connectivity
cf-memory serve                         # MCP (stdio)
cf-memory a2a --port 9120               # A2A on localhost
cf-memory card                          # print agent card

hermes cloudflare-memory status
hermes cloudflare-memory namespaces

Landing-Page bereitstellen (optional)

Das Plugin selbst ist kein Worker. Die öffentliche Seite unter cloudflare-memory.pages.dev ist eine statische Cloudflare-Pages-Site.

# token needs Pages:Edit on the same account
export CLOUDFLARE_API_TOKEN=...
export CLOUDFLARE_ACCOUNT_ID=...
npx wrangler pages deploy ./public --project-name cf-memory-plugin

Pages-Dokumentation · Wrangler

Danksagungen

• Speicher-Backend: Cloudflare Agent Memory (Blog, Discord, Community)

• Protokoll: Model Context Protocol

• Hermes-Anbietervertrag: Nous Research Hermes Agent

• HTTP-Client: httpx

Dieses Repository ist weder mit Cloudflare noch mit Nous Research verbunden.

Lizenz

MIT