README.md
Turn AI into a personal assistant with permanent memory.
Knowledge MCP Server
Biến AI thành trợ lý cá nhân có trí nhớ vĩnh viễn.
Quản lý công việc, ghi chú, mục tiêu và kiến thức — tất cả bằng ngôn ngữ tự nhiên. Mọi thứ được lưu trên GitHub, có version control, truy cập từ bất kỳ đâu.
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
Không cần nhớ tên lệnh. Nói tự nhiên. AI tự hiểu.
Tại sao dùng Knowledge MCP?
AI thông thường quên sau mỗi cuộc hội thoại. Knowledge MCP cho AI bộ nhớ dài hạn — lưu một lần, dùng mãi mãi.
- Trí nhớ vĩnh viễn — Kiến thức lưu trên GitHub, không bao giờ mất. AI trả lời dựa trên dữ liệu bạn đã lưu, không bịa.
- Quản lý công việc bằng giọng nói tự nhiên — Thêm task, đánh dấu xong, xem backlog — không cần mở app nào khác.
- Knowledge base cá nhân — Lưu quy trình, chính sách, ghi chú kỹ thuật, bất kỳ thứ gì. AI tìm và trả lời chính xác khi bạn hỏi lại.
- Phân tích năng suất — AI phân tích thói quen làm việc, phát hiện vấn đề, gợi ý cải thiện cụ thể.
- Version control — Mỗi hành động là một git commit. Xem lịch sử, rollback bất kỳ lúc nào.
- Hoạt động trên mọi AI platform — Claude Desktop, Cursor, VS Code, Windsurf, Claude Code CLI, và bất kỳ MCP client nào.
Demo nhanh
Quản lý công việc
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" ✓
Knowledge base
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.
Phân tích năng suất
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
Khả năng tự học
Knowledge MCP không chỉ lưu trữ — nó học từ hành vi của bạn và ngày càng thông minh hơn theo thời gian.
Càng dùng càng thông minh
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
Mỗi lần bạn lưu kiến thức, AI có thêm dữ liệu để tham chiếu. Hệ thống search-before-answer: AI tự tìm trong knowledge base trước khi trả lời, ưu tiên dữ liệu thực thay vì bịa.
Phân tích hành vi — 5 bộ phát hiện
AI phân tích lịch sử commit + task patterns để hiểu thói quen của bạn — hoàn toàn bằng thuật toán, không dùng LLM:
| Detector | Phát hiện | Ví dụ |
|---|---|---|
| Productivity | Chronotype, peak hours, xu hướng hoạt động | "Bạn hiệu quả nhất 9-11h sáng, hoạt động giảm 40% tuần này" |
| Procrastination | Priority inversion, overdue tích tụ | "3 task quan trọng bị bỏ qua, trong khi 5 task nhỏ đã xong" |
| Task Structure | Task mơ hồ, quá lớn, thiếu metadata | "4 task chỉ có 2-3 từ, khó hành động" |
| Goal Alignment | Task vs mục tiêu bị lệch | "Chỉ 25% task liên quan đến mục tiêu đã đề ra" |
| Workload | Quá tải, inbox tồn đọng, backlog phình | "Hôm nay ước lượng 12h work — không khả thi" |
Kết quả: healthScore (0-100) + insights xếp theo mức nghiêm trọng + gợi ý cụ thể.
Tự động tối ưu — Self-Optimizing Engine
AI không chỉ phân tích — nó tự sửa hệ thống task của bạ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.
Luôn preview trước — bạn duyệt rồi mới áp dụng. Toàn bộ thay đổi gộp trong 1 atomic commit.
Học từ thời gian
Hệ thống phát hiện patterns theo thời gian thực:
- Chronotype — early-bird hay night-owl (từ timestamp commits)
- Consistency — bao nhiêu n
Tools (4)
manage_tasksAdd, update, complete, or list tasks in the knowledge base.manage_knowledgeStore, retrieve, or search for information in the knowledge base.analyze_productivityGenerate insights and reports based on task patterns and commit history.optimize_tasksAutomatically reschedule, prioritize, or clean up tasks.Environment Variables
GITHUB_TOKENrequiredGitHub personal access token for repository access.REPO_URLrequiredThe URL of the GitHub repository used as the knowledge base.Configuration
claude_desktop_config.json
{"mcpServers": {"knowledge": {"command": "npx", "args": ["-y", "@vuluu2k/knowledge_mcp"], "env": {"GITHUB_TOKEN": "your_token", "REPO_URL": "your_repo_url"}}}}Try it
→What tasks do I have scheduled for today?
→Add a new task: design the landing page for the new project.
→Remember this: the company return policy is 7 days for unused items.
→Analyze my productivity for this week and suggest improvements.
→Optimize my task list by rescheduling overdue items.