home-memo-mcp

個人ナレッジノート (~/.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      │
└──────────────────────────────┘

コンポーネント一覧