Fork từ rahilp/second-brain-cloudflare — đã tối ưu cho tiếng Việt và hướng dẫn tích hợp với Antigravity + Codex.

AI Client (Antigravity/Codex/Claude)
    │
    ▼ MCP Protocol (HTTP + SSE)
┌─────────────────────────────────────┐
│   Cloudflare Worker (second-brain)  │
│   ├── /mcp    → MCP Server         │
│   ├── /capture → REST API          │
│   └── /list   → REST API           │
├─────────────────────────────────────┤
│   Workers AI (qwen3-embedding)     │ ← Tạo embedding vector
│   Cloudflare D1 (SQLite)           │ ← Lưu nội dung gốc
│   Cloudflare Vectorize (1024-dim)  │ ← Tìm kiếm semantic
└─────────────────────────────────────┘

Toàn bộ chạy trên Cloudflare free tier. Không cần server riêng, không lo downtime.

• Node.js 18+
• Tài khoản Cloudflare (free tier đủ dùng)

# 1. Clone repo
git clone https://github.com/chithanh85/second-brain-cloudflare.git
cd second-brain-cloudflare
npm install

# 2. Đăng nhập Cloudflare
npx wrangler login

# 3. Tạo database D1
npm run db:create
# → Copy database_id từ output, paste vào wrangler.toml → [[d1_databases]] → database_id

# 4. Tạo Vectorize index (1024 dimensions cho qwen3-embedding)
npm run vectors:create

# 5. Migrate schema lên remote
npm run db:migrate:remote

# 6. Đặt token bảo mật
"your-secret-token-here" | npx wrangler secret put AUTH_TOKEN

# 7. Deploy
npm run deploy

Sau khi deploy thành công, bạn sẽ nhận được URL dạng:

https://second-brain.<your-subdomain>.workers.dev

Mở file ~/.gemini/antigravity/mcp_config.json và thêm:

{
  "mcpServers": {
    "second-brain": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://second-brain.<your-subdomain>.workers.dev/mcp",
        "--header",
        "Authorization:Bearer <your-auth-token>"
      ]
    }
  }
}

Restart Antigravity để áp dụng. Sau đó AI sẽ tự động có thêm 5 tools:

• remember — Lưu ghi chú
• recall — Tìm kiếm ngữ nghĩa (semantic search)
• append — Cập nhật ghi chú đã có
• list_recent — Liệt kê gần nhất
• forget — Xóa ghi chú

Mở file ~/.codex/config.toml và thêm:

[mcp_servers.second-brain]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://second-brain.<your-subdomain>.workers.dev/mcp",
  "--header",
  "Authorization:Bearer <your-auth-token>"
]

Restart Codex để áp dụng.

Mở file claude_desktop_config.json và thêm:

{
  "mcpServers": {
    "second-brain": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://second-brain.<your-subdomain>.workers.dev/mcp",
        "--header",
        "Authorization:Bearer <your-auth-token>"
      ]
    }
  }
}

Khi đã config xong, AI sẽ tự động sử dụng các tools. Ví dụ:

• Bạn nói: "Nhớ giúp tôi: API backend dùng port 3000" → AI gọi remember lưu lại

• Bạn hỏi: "Backend dùng port mấy?" → AI gọi recall tìm và trả lời

• Bạn nói: "Cập nhật: backend đã đổi sang port 3001" → AI gọi append thêm update vào entry cũ

# Lưu ghi chú
curl -X POST https://second-brain.<subdomain>.workers.dev/capture \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"content": "Nội dung ghi chú", "tags": ["tag1"], "source": "api"}'

# Liệt kê
curl https://second-brain.<subdomain>.workers.dev/list?n=10 \
  -H "Authorization: Bearer <token>"

qwen3-embedding-0.6b được chọn sau khi benchmark với bge-m3 vì:

1. MTEB score cao hơn ~7-8% — Semantic search chính xác hơn
2. 32K context window — Ghi chú dài không bị cắt (bge-m3 chỉ 8K)
3. Instruction-aware — Có thể thêm task-specific prompt để tăng chất lượng
4. Matryoshka Representation Learning (MRL) — Linh hoạt dimensions (32–1024)
5. 100+ ngôn ngữ — Tiếng Việt, tiếng Anh, tiếng Nhật, tiếng Hàn...
6. Cùng giá với bge-m3 — $0.012/1M tokens, 1,075 neurons/1M tokens

# Tạo file .dev.vars với nội dung:
# AUTH_TOKEN=test-token-local

# Migrate schema local
npm run db:migrate

# Chạy dev server (cần Cloudflare auth vì AI + Vectorize chạy remote)
npx wrangler dev --experimental-vectorize-bind-to-prod

# Test capture
Invoke-RestMethod -Uri "http://127.0.0.1:8787/capture" `
  -Method POST `
  -Headers @{"Authorization"="Bearer test-token-local"; "Content-Type"="application/json"} `
  -Body '{"content": "Test tieng Viet", "tags": ["test"], "source": "api"}'

MIT