CF Memory Plugin

Memoria persistente para agentes de IA, respaldada por Cloudflare Agent Memory.

Este plugin es un cliente ligero. Cloudflare almacena, clasifica y recupera memorias. No necesitas ejecutar una base de datos vectorial, un pipeline de embeddings ni un Worker.

Beta privada. Se requiere Workers de pago. Workers de pago por sí solo no es suficiente: aún necesitas el derecho de acceso a Agent Memory.

Configuración en 60 segundos

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 es obligatorio. No hay cuenta predeterminada. Encuéntralo en la barra lateral del panel de Cloudflare.

Crea el token en dash.cloudflare.com/profile/api-tokens con el permiso Agent Memory únicamente. No reutilices una Global API Key.

Related MCP server: agentram-mcp

Qué es esto

Coste

Recomendado: Workers de pago en la cuenta que almacenará la memoria. No pongas memoria de producción en una cuenta gratuita. No asumas que toda cuenta de Workers de pago tiene Agent Memory: verificamos que pago ≠ derecho de acceso.

Después de la beta, trata Agent Memory como una factura separada. Cloudflare aún no ha publicado las tarifas de disponibilidad general.

Dependencias

Entorno de ejecución:

Opcional:

No se requiere ningún binding de Cloudflare Worker, Wrangler, D1, Vectorize o Workers AI para este plugin. Esos son productos de Cloudflare que este cliente no utiliza.

Seguridad

Sigue las reglas de tokens de Cloudflare: mejores prácticas para tokens de API.

• Almacena MCP_CLOUDFLARE_API_KEY en el entorno o en un almacén de secretos. Nunca lo confirmes en el repositorio.

• Limita el token a Agent Memory en una sola cuenta.

• Establece CF_ACCOUNT_ID tú mismo. Este plugin no recurrirá a otra cuenta.

• cf-memory a2a se vincula a 127.0.0.1 por defecto. No lo expongas a Internet público sin autenticación.

• ingest y sync_turn envían texto de conversación a Cloudflare. No ingieras secretos, contraseñas o PII de clientes que no tengas permitido almacenar.

• Usa un namespace por aplicación y un perfil por usuario/tenant.

• Rota el token desde la página de API Tokens si se filtra.

Consulta SECURITY.md.

Úsalo desde un agente

El mismo bloque MCP en todas partes. Solo cambia la ruta del archivo de configuración.

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

Hermes es el único proveedor nativo. Realiza una precarga en segundo plano para que la recuperación no añada ~5s a cada turno.

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

Implementa la página de destino (opcional)

El plugin en sí no es un Worker. La página pública en cloudflare-memory.pages.dev es un sitio estático de Cloudflare Pages.

# 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

Documentación de Pages · Wrangler

Créditos

• Backend de memoria: Cloudflare Agent Memory (blog, Discord, Comunidad)

• Protocolo: Model Context Protocol

• Contrato de proveedor de Hermes: Nous Research Hermes Agent

• Cliente HTTP: httpx

Este repositorio no está afiliado con Cloudflare ni con Nous Research.

Licencia

MIT