Bạn nói                              AI làm
─────────────────────────────────────────────────────────
"Hôm nay tôi cần làm gì?"           → Xem tasks hôm nay
"Thêm task: thiết kế landing page"   → Tạo task mới
"Xong task review PR rồi"            → Đánh dấu hoàn thành
"Lưu kiến thức Docker: dùng alpine"  → Lưu vào knowledge base
"Chính sách bảo hành thế nào?"       → Tìm và trả lời từ dữ liệu đã lưu
"Phân tích năng suất của tôi"        → Báo cáo insights + gợi ý cải thiện

Bạn: Hôm nay tôi cần làm gì?
AI:  Bạn có 3 tasks hôm nay:
     1. !! Review PR của Minh #dev @due(2025-03-20)
     2. Thiết kế landing page #design
     3. Fix bug login page #dev

Bạn: Xong task review PR rồi
AI:  Đã đánh dấu hoàn thành "Review PR của Minh" ✓

Bạn: Ghi nhớ: chính sách đổi trả là 7 ngày, sản phẩm còn nguyên tem
AI:  Đã lưu vào knowledge base, topic "chinh-sach" với tags: đổi trả, chính sách

Bạn: Khách hỏi chính sách đổi trả thế nào?
AI:  Theo dữ liệu đã lưu: Chính sách đổi trả là 7 ngày, sản phẩm còn nguyên tem.

Bạn: Phân tích năng suất của tôi tuần này
AI:  ## Insights
     - Bạn hoạt động nhiều nhất lúc 9-11h sáng (65% commits)
     - Completion rate: 72% — khá tốt

     ## Vấn đề
     - 3 tasks quá hạn, task "Refactor auth module" trễ 5 ngày
     - 4 tasks không có deadline — dễ bị trì hoãn
     - Backlog đang phình (12 items), có vẻ chưa được review

     ## Gợi ý
     - Đặt deadline cho 4 tasks đang thiếu
     - Review và dọn backlog — bỏ hoặc lên lịch cụ thể
     - Chia nhỏ "Refactor auth module" — task quá lớn

Tuần 1: AI trả lời từ kiến thức chung
Tuần 4: AI trả lời chính xác từ DỮ LIỆU BẠN ĐÃ LƯU
        — chính sách, quy trình, kiến thức kỹ thuật, tất cả đều có nguồn

Bạn: Tối ưu tasks cho tôi

AI:  Preview (dry run):
     1. autoReschedule — chuyển 2 task quá hạn từ backlog → today
     2. autoSplitTask  — chia "Refactor auth" (8h) thành 3 subtasks
     3. autoPrioritize — đẩy "Fix critical bug" lên today
     4. autoCleanup    — xóa 1 task trùng lặp
     5. autoInjectTask — tạo task cho goal "học React" (chưa có task nào)

     Áp dụng không?

Bạn: OK

AI:  Đã áp dụng 5 thay đổi trong 1 commit.

curl -fsSL https://raw.githubusercontent.com/vuluu2k/knowledge_mcp/main/install.sh -o install.sh && bash install.sh

Invoke-WebRequest -Uri https://raw.githubusercontent.com/vuluu2k/knowledge_mcp/main/install.ps1 -OutFile install.ps1; .\install.ps1

git clone https://github.com/vuluu2k/knowledge_mcp.git
cd knowledge_mcp
./install.sh

git clone https://github.com/vuluu2k/knowledge_mcp.git
cd knowledge_mcp
.\install.ps1

git clone https://github.com/vuluu2k/knowledge_mcp.git
cd knowledge_mcp
npm install && npm run build
cp .env.example .env
# Sửa .env với token + repo info

{
  "mcpServers": {
    "knowledge-brain": {
      "command": "node",
      "args": ["/path/to/knowledge_mcp/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "ghp_...",
        "GITHUB_OWNER": "yourusername",
        "GITHUB_REPO": "brain"
      }
    }
  }
}

claude mcp add knowledge-brain -- node /path/to/knowledge_mcp/dist/index.js

{
  "mcpServers": {
    "knowledge-brain": {
      "command": "node",
      "args": ["/path/to/knowledge_mcp/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "ghp_...",
        "GITHUB_OWNER": "yourusername",
        "GITHUB_REPO": "brain"
      }
    }
  }
}

{
  "servers": {
    "knowledge-brain": {
      "command": "node",
      "args": ["/path/to/knowledge_mcp/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "ghp_...",
        "GITHUB_OWNER": "yourusername",
        "GITHUB_REPO": "brain"
      }
    }
  }
}

{
  "mcpServers": {
    "knowledge-brain": {
      "command": "node",
      "args": ["/path/to/knowledge_mcp/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "ghp_...",
        "GITHUB_OWNER": "yourusername",
        "GITHUB_REPO": "brain"
      }
    }
  }
}

{
  "mcpServers": {
    "knowledge-brain": {
      "command": "node",
      "args": ["/path/to/knowledge_mcp/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "ghp_...",
        "GITHUB_OWNER": "yourusername",
        "GITHUB_REPO": "brain"
      }
    }
  }
}

{
  "mcpServers": {
    "knowledge-brain": {
      "command": "node",
      "args": ["/path/to/knowledge_mcp/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "ghp_...",
        "GITHUB_OWNER": "yourusername",
        "GITHUB_REPO": "brain"
      }
    }
  }
}

Khởi tạo brain cho tôi

brain/
├── inbox/capture.md           ← Ghi nhanh
├── tasks/
│   ├── today.md               ← Việc hôm nay
│   └── backlog.md             ← Việc để dành
├── notes/
│   ├── ideas.md               ← Ý tưởng
│   └── learning.md            ← Kiến thức học được
├── goals/
│   ├── short-term.md          ← Mục tiêu ngắn hạn
│   └── long-term.md           ← Mục tiêu dài hạn
└── knowledge/
    └── general.md             ← Knowledge base

---
name: Chính sách bán hàng
description: Quy định đổi trả, bảo hành, hoàn tiền
tags: chính sách, đổi trả, bảo hành
---

## Chính sách đổi trả
- Đổi trả trong vòng 7 ngày, sản phẩm còn nguyên tem

## Bảo hành
- Sản phẩm điện tử: 12 tháng

GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx   # Bắt buộc
GITHUB_OWNER=yourusername               # Bắt buộc
GITHUB_REPO=brain                       # Bắt buộc
GITHUB_BRANCH=main                      # Mặc định: main
BRAIN_BASE_PATH=brain                   # Mặc định: brain
LOG_LEVEL=info                          # debug | info | warn | error
CACHE_TTL_MS=30000                      # Cache reads (ms)
WRITE_RETRIES=3                         # Retry khi conflict

# Nếu cài bằng curl (mặc định ~/.knowledge-brain-mcp)
curl -fsSL https://raw.githubusercontent.com/vuluu2k/knowledge_mcp/main/update.sh -o update.sh && bash update.sh

# Hoặc chạy trực tiếp trong thư mục đã clone
./update.sh

# Nếu cài mặc định (~\.knowledge-brain-mcp)
Invoke-WebRequest -Uri https://raw.githubusercontent.com/vuluu2k/knowledge_mcp/main/update.ps1 -OutFile update.ps1; .\update.ps1

# Hoặc chạy trực tiếp trong thư mục đã clone
.\update.ps1

[INFO] Phiên bản hiện tại: a1b2c3d
[INFO] Đang tải bản mới nhất...
[OK] Đã cập nhật: a1b2c3d → e4f5g6h

[INFO] Thay đổi:
  e4f5g6h feat: add auto-action engine
  d3c2b1a fix: knowledge search ranking

[OK] Đã cập nhật dependencies
[OK] Build hoàn tất
[OK] .env đầy đủ

═══════════════════════════════════════════════════
  Cập nhật hoàn tất!
═══════════════════════════════════════════════════
  Khởi động lại IDE để sử dụng bản mới.

# macOS / Linux
./update.sh ~/my-custom-path

# Windows
.\update.ps1 -Path "C:\my-custom-path"

./install.sh --uninstall

.\install.ps1 -Uninstall

Claude/AI ◄──stdio──► MCP Server ◄──HTTPS──► GitHub API ◄──► brain/ repo

src/
├── index.ts              # Entry point
├── mcp.ts                # Đăng ký tools + server instructions
├── config.ts             # Env vars
├── logger.ts             # JSON logger → stderr
├── errors.ts             # Error types
├── core/
│   ├── brain.ts          # Brain facade (tasks, notes, goals, inbox)
│   ├── parser.ts         # Markdown ↔ structured data
│   ├── knowledge.ts      # Knowledge base (frontmatter + search)
│   ├── insights.ts       # Insight engine (analytics + patterns)
│   └── aggregator.ts     # Cross-file queries
├── github/
│   ├── client.ts         # GitHub API (cache + retry)
│   └── sync.ts           # Section → file path mapping
└── tools/
    ├── helpers.ts        # Tool wrapper
    ├── brain.ts          # initBrain
    ├── tasks.ts          # Task tools (5)
    ├── notes.ts          # Note + goal tools (3)
    ├── inbox.ts          # Inbox tools (2)
    ├── knowledge.ts      # Knowledge tools (4)
    └── insights.ts       # Insight tool (1)