Enables searching personal knowledge notes stored in Cloudflare R2 via Cloudflare AI Search, with authentication through Cloudflare Access.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@home-memo-mcp search knowledge about Cloudflare Worker deployment"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
個人ナレッジノート (~/.nb/home/knowledge/*.md) を、Model Context Protocol (MCP) 経由で検索できるようにする Cloudflare Worker。
search_knowledge ツール 1 本を公開する薄いラッパー。実際の RAG は Cloudflare AI Search が担当し、Worker は MCP プロトコルへの変換と Cloudflare Access による認証境界の 2 役だけを持つ。
┌──────────────────────────────┐
│ ~/.nb/home (ローカル) │
│ knowledge/*.md │
└──────────────┬───────────────┘
│ git push
▼
┌──────────────────────────────┐
│ GitHub: Koutaro-Hanabusa/ │
│ home-memo (private) │
└──────────────┬───────────────┘
│ GitHub Actions
│ (sync-ai-search.yml)
│ ・rclone で *.md を R2 に sync
│ ・AI Search を reindex キック
▼
┌──────────────────────────────┐
│ Cloudflare R2 bucket: │
│ home-memo │
└──────────────┬───────────────┘
│ (source binding)
▼
┌──────────────────────────────┐
│ Cloudflare AI Search: │
│ instance = home-memo │
│ embedding = │
│ @cf/qwen/qwen3- │
│ embedding-0.6b │
└──────────────┬───────────────┘
│ Workers binding (HOME_MEMO)
│ ※ 内部認証、Bearer 不要
▼
┌──────────────────────────────┐
│ Worker: home-memo-mcp │◄─ Durable Object
│ このリポ │ HomeMemoMCP (SQLite)
│ /mcp → HomeMemoMCP │ MCP セッション状態
└──────────────┬───────────────┘
│ custom domain
▼
┌──────────────────────────────┐
│ home-memo-mcp.burio16.com │
│ Cloudflare Access で保護 │
│ (Service Token ポリシー) │
└──────────────┬───────────────┘
│ MCP over Streamable HTTP
│ + CF-Access-Client-Id/Secret header
▼
┌──────────────────────────────┐
│ Claude Code │
│ ~/.mcp.json │
│ → mcp__home-memo__ │
│ search_knowledge │
└──────────────────────────────┘Related MCP server: Markdown RAG MCP
層 | 名前 | 種別 | 補足 |
ソース | GitHub repo (private) | ノート本体 ( | |
同期 |
| GitHub Actions | 上記 repo 側に配置。rclone で R2 に sync → AI Search を reindex |
ストレージ |
| R2 bucket | markdown の実体置き場 |
RAG |
| Cloudflare AI Search instance | chunk / embed / retrieval を丸ごとマネージド (旧 AutoRAG) |
埋め込み |
| Workers AI モデル | AI Search が内部で使用 |
実行時 |
| Cloudflare Worker (このリポ) | MCP サーバー本体 |
セッション |
| Durable Object (SQLite) | McpAgent が要求するステートフル SSE 用 |
ドメイン |
| Custom domain | Worker のフロント |
認証 | Cloudflare Access | Zero Trust Application | Service Token ポリシーで CLI/Claude Code からアクセス |
This server cannot be deployed
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
Hosted MCP memory: save sessions/decisions once, search from Claude, Cursor, ChatGPT. EU-hosted FTS.
Private persistent memory for Claude, ChatGPT & Gemini via MCP - semantic search, zero-code setup.
Read-only search and Markdown access to liz's public docs, prompts, resources, and an MCP App.
