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 は環境変数またはシークレットストアに保存してください。コミットしないでください。

• トークンを1つのアカウントの Agent Memory に限定してください。

• CF_ACCOUNT_ID は自分で設定してください。このプラグインは他のアカウントにフォールバックしません。

• cf-memory a2a はデフォルトで 127.0.0.1 にバインドします。認証なしで公開インターネットに公開しないでください。

• ingest と sync_turn は会話テキストを Cloudflare に送信します。保存が許可されていないシークレット、パスワード、顧客の個人情報をインジェストしないでください。

• アプリごとに1つの名前空間、ユーザー/テナントごとに1つのプロファイルを使用してください。

• 漏洩した場合は 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 は唯一のネイティブプロバイダーです。バックグラウンドでプリフェッチするため、リコールが毎ターン約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