CF Memory Plugin

AI 에이전트를 위한 영구 메모리로, Cloudflare Agent Memory를 기반으로 합니다.

이 플러그인은 경량 클라이언트입니다. Cloudflare가 메모리를 저장, 분류, 회상합니다. 벡터 DB, 임베딩 파이프라인, Worker를 직접 실행할 필요가 없습니다.

비공개 베타. 유료 Workers가 필요합니다. 유료 Workers만으로는 부족합니다 — Agent Memory 사용 권한이 별도로 필요합니다.

60초 설정

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는 필수입니다. 기본 계정이 없습니다. Cloudflare 대시보드 사이드바에서 찾을 수 있습니다.

토큰은 dash.cloudflare.com/profile/api-tokens에서 Agent Memory 권한만으로 생성하세요. Global API Key를 재사용하지 마세요.

Related MCP server: agentram-mcp

이 플러그인의 역할

비용

권장 사항: 메모리를 보관할 계정에 Workers Paid를 사용하세요. 프로덕션 메모리를 무료 계정에 두지 마세요. 모든 유료 Workers 계정에 Agent Memory 권한이 있다고 가정하지 마세요 — 유료가 곧 권한 보유를 의미하지 않음을 확인했습니다.

베타 이후에는 Agent Memory를 별도 청구 항목으로 취급하세요. Cloudflare는 아직 GA 요금을 공개하지 않았습니다.

의존성

런타임:

선택 사항:

이 플러그인에는 Cloudflare Worker, Wrangler, D1, Vectorize, Workers AI 바인딩이 필요하지 않습니다. 이 클라이언트가 사용하지 않는 Cloudflare 제품들입니다.

보안

Cloudflare의 토큰 규칙을 따르세요: API 토큰 모범 사례.

• MCP_CLOUDFLARE_API_KEY를 환경 변수 또는 비밀 저장소에 보관하세요. 절대 커밋하지 마세요.

• 토큰 범위를 단일 계정의 Agent Memory로 한정하세요.

• CF_ACCOUNT_ID를 직접 설정하세요. 이 플러그인은 다른 계정으로 대체하지 않습니다.

• cf-memory a2a는 기본적으로 127.0.0.1에 바인딩됩니다. 인증 없이 공개 인터넷에 노출하지 마세요.

• ingest와 sync_turn은 대화 텍스트를 Cloudflare로 전송합니다. 저장이 허용되지 않은 비밀번호, 비밀, 고객 PII를 수집하지 마세요.

• 앱마다 네임스페이스 하나, 사용자/테넌트마다 프로필 하나를 사용하세요.

• 토큰이 유출된 경우 API 토큰 페이지에서 교체하세요.

SECURITY.md를 참조하세요.

에이전트에서 사용하기

모든 곳에서 동일한 MCP 블록을 사용합니다. 구성 파일 경로만 변경됩니다.

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

Hermes만이 네이티브 제공자입니다. 백그라운드에서 미리 가져오므로 recall이 매 턴마다 ~5초를 추가하지 않습니다.

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

랜딩 페이지 배포 (선택 사항)

플러그인 자체는 Worker가 아닙니다. cloudflare-memory.pages.dev의 공개 페이지는 정적 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

Pages 문서 · Wrangler

크레딧

• 메모리 백엔드: Cloudflare Agent Memory (블로그, Discord, 커뮤니티)

• 프로토콜: Model Context Protocol

• Hermes 제공자 계약: Nous Research Hermes Agent

• HTTP 클라이언트: httpx

이 저장소는 Cloudflare 또는 Nous Research와 제휴 관계가 아닙니다.

라이선스

MIT