Knowledge Server

БесплатноHosted

Transforms a GitHub repository into a structured personal brain for AI to manage tasks, notes, and goals through markdown files. It enables direct interaction w

автор: vuluu2k

GitHub

Описание

Transforms a GitHub repository into a structured personal brain for AI to manage tasks, notes, and goals through markdown files. It enables direct interaction with a version-controlled knowledge base, allowing for automated organization and efficient retrieval of information.

README

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 ngày có hoạt động trong 14 ngày qua
Trend — năng suất đang tăng, giảm, hay ổn định
Weekend work — có đang làm việc cuối tuần quá nhiều không

Càng dùng lâu, phân tích càng chính xác vì có nhiều dữ liệu lịch sử hơn.

Cài đặt (2 phút)

Yêu cầu

Node.js >= 18
GitHub account + Personal Access Token (tạo tại đây — cần quyền repo)
Một repo rỗng trên GitHub (ví dụ: brain)

Cách 1: Một lệnh duy nhất

macOS / Linux:

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

Windows (PowerShell):

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

Clone, install, build, cấu hình .env interactive, in ra config sẵn cho AI platform của bạn.

Script tự động kiểm tra và cài Node.js nếu chưa có (hỗ trợ winget, Chocolatey, Scoop, hoặc tải installer trực tiếp).

Cách 2: Clone + script

macOS / Linux:

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

Windows (PowerShell):

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

Cách 3: Thủ công

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

Kết nối với AI Platform

MCP server chạy qua stdio — tương thích mọi platform hỗ trợ MCP.

Thay /path/to/knowledge_mcp bằng đường dẫn thực tế. Script install.sh sẽ in ra config copy-paste sẵn.

Claude Desktop

File: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) hoặc %APPDATA%\Claude\claude_desktop_config.json (Windows)

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

Claude Code (CLI)

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

Cursor

Settings > MCP Servers > Add new:

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

VS Code (Copilot / Roo Code / Continue)

File .vscode/mcp.json trong project hoặc global settings:

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

Windsurf

File ~/.codeium/windsurf/mcp_config.json:

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

OpenAI Codex CLI

File ~/.codex/config.json:

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

Antigravity

Project settings > Integrations > MCP > Add server:

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

Bất kỳ MCP Client nào

Field	Value
Command	`node`
Args	`/path/to/knowledge_mcp/dist/index.js`
Env	`GITHUB_TOKEN`, `GITHUB_OWNER`, `GITHUB_REPO`

Transport: stdio (mặc định).

Bắt đầu sử dụng

Bước 1 — Khởi tạo (chỉ 1 lần)

Tạo một repo rỗng trên GitHub, cấu hình xong, rồi nói:

Khởi tạo brain cho tôi

AI tạo toàn bộ cấu trúc trong 1 commit:

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

Bước 2 — Dùng hàng ngày

Nói chuyện tự nhiên. AI tự chọn tool phù hợp.

Bạn nói	AI hiểu
"thêm task", "nhắc tôi", "cần làm"	Tạo task mới
"xong rồi", "done", "hoàn thành"	Đánh dấu task xong
"ghi lại", "note", "ý tưởng"	Thêm ghi chú
"nhớ giùm", "capture", "lưu nhanh"	Lưu vào inbox
"lưu kiến thức", "ghi nhớ rằng"	Lưu vào knowledge base
"tìm", "nhắc lại", "có ghi gì về"	Tìm trong knowledge
"phân tích năng suất", "review"	Báo cáo insights

Chi tiết hơn: GUIDE.md — hướng dẫn chat với AI agent hiệu quả.

Danh sách Tools (16)

Khởi tạo

Tool	Mô tả
`initBrain`	Tạo toàn bộ cấu trúc brain trên repo rỗng (1 commit)

Tasks (5 tools)

Tool	Input	Mô tả
`getTasks`	`section` (today/backlog/all)	Lấy tasks theo section
`getTodayTasks`	—	Tasks hôm nay
`getBacklog`	—	Tasks backlog
`addTask`	`text`, `target`	Thêm task mới
`markTaskDone`	`taskId` hoặc `text`	Đánh dấu hoàn thành

Notes / Goals / Inbox (5 tools)

Tool	Input	Mô tả
`getNotes`	`section` (ideas/learning)	Lấy ghi chú
`addNote`	`content`, `file`	Thêm ghi chú
`getGoals`	`section` (short-term/long-term)	Lấy mục tiêu
`getInbox`	—	Lấy inbox
`saveToInbox`	`content`	Lưu nhanh vào inbox

Knowledge Base (4 tools)

Tool	Input	Mô tả
`listTopics`	—	Danh sách topics (name + description + tags)
`getKnowledge`	`topic`	Đọc toàn bộ 1 topic
`addKnowledge`	`topic`, `title`, `content`, `description?`, `tags?`	Thêm kiến thức
`searchKnowledge`	`query`	Tìm kiếm cross-topic (tag > title > content)

Insights & Analytics (1 tool)

Tool	Input	Mô tả
`getInsights`	—	Phân tích năng suất, phát hiện vấn đề, gợi ý cải thiện

getInsights phân tích:

Completion rate — tỷ lệ hoàn thành tasks
Overdue tasks — tasks quá hạn và số ngày trễ
Task quality — phát hiện tasks thiếu priority, deadline, hoặc mô tả quá mơ hồ
Activity patterns — giờ nào và ngày nào bạn hoạt động nhiều nhất (từ commit history)
Goal alignment — tasks hôm nay có khớp với mục tiêu không
Inbox health — bao nhiêu items chưa xử lý

Knowledge Base

Lưu trữ kiến thức theo topic. Mỗi file có frontmatter + entries:

---
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

Search ranking

Tag match — "bảo hành" match tag > trả về tất cả entries của topic
Title match — match heading ##
Content match — match nội dung

AI tự động tìm trong knowledge base trước khi trả lời. Nếu có dữ liệu đã lưu, AI dùng dữ liệu đó — không bịa.

Cấu hình `.env`

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

Cập nhật

macOS / Linux:

# 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

Windows (PowerShell):

# 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

Script tự động xử lý toàn bộ:

Phát hiện thay đổi local — nếu bạn đã sửa code, script hỏi:
- Lưu tạm (stash) rồi cập nhật
- Ghi đè thay đổi local
- Hủy cập nhật
Pull bản mới nhất từ GitHub
Hiển thị changelog — những gì đã thay đổi
Cài lại dependencies nếu có package mới
Rebuild TypeScript — dist/ được build lại hoàn toàn
Kiểm tra .env — báo nếu có biến môi trường mới cần thêm

[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.

Nếu cài ở thư mục khác (không phải mặc định), truyền đường dẫn:

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

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

Gỡ cài đặt

macOS / Linux:

./install.sh --uninstall

Windows (PowerShell):

.\install.ps1 -Uninstall

Xóa thư mục server + tự động gỡ config khỏi tất cả IDE (Claude Desktop, Claude Code, Cursor, Windsurf...).

Scripts

macOS / Linux

Lệnh	Mô tả
`curl ... -o install.sh && bash install.sh`	Cài từ xa — clone, build, cấu hình IDE tự động
`./install.sh`	Cài đặt (hoạt động cả local lẫn curl pipe)
`./install.sh --uninstall`	Gỡ cài đặt + xóa config IDE
`./update.sh`	Cập nhật — pull, rebuild, check .env

Windows (PowerShell)

Lệnh	Mô tả
`Invoke-WebRequest ... -OutFile install.ps1; .\install.ps1`	Cài từ xa
`.\install.ps1`	Cài đặt
`.\install.ps1 -Uninstall`	Gỡ cài đặt + xóa config IDE
`.\update.ps1`	Cập nhật — pull, rebuild, check .env
`.\update.ps1 -Path "C:\path"`	Cập nhật thư mục chỉ định

Chung

Lệnh	Mô tả
`npm run build`	Build TypeScript
`npm run start`	Chạy server
`npm run dev`	Dev mode (tsx)

Kiến trúc

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

Nguyên tắc: MCP server chỉ xử lý dữ liệu. Toàn bộ suy luận do AI đảm nhận.

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)

Kỹ thuật

Git Tree API — initBrain tạo tất cả file trong 1 commit, hoạt động trên repo rỗng
TTL Cache — reads cached 30s, writes tự invalidate
Atomic writes — SHA conflict (409) tự retry 3 lần
Format-preserving — sửa task chỉ thay đúng dòng, không rewrite file
CRLF safe — normalize line endings, hỗ trợ frontmatter, priority (!/!!/!!!), due dates (@due())
Tag-first search — knowledge search ưu tiên tag match, không cần đọc content
Commit history analysis — phân tích patterns từ lịch sử commit cho insights
Server instructions — AI agent nhận instructions khi kết nối, hiểu ngay cách dùng

Use Cases

Cho cá nhân

Quản lý tasks hàng ngày bằng ngôn ngữ tự nhiên
Lưu kiến thức kỹ thuật (Docker, Git, API endpoints...)
Theo dõi mục tiêu và tiến độ
Phân tích thói quen làm việc

Cho team / doanh nghiệp

Knowledge base chính sách (đổi trả, bảo hành, quy trình)
AI customer support trả lời dựa trên dữ liệu thực
Onboarding — nhân viên mới hỏi AI về quy trình nội bộ
Lưu và tra cứu tài liệu kỹ thuật

License

MIT

Как установить

Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.

{
  "mcpServers": {
    "knowledge-mcp-server": {
      "command": "npx",
      "args": []
    }
  }
}

Command Palette

Knowledge Server

Описание

README

Tại sao dùng Knowledge MCP?

Demo nhanh

Quản lý công việc

Knowledge base

Phân tích năng suất

Khả năng tự học

Càng dùng càng thông minh

Phân tích hành vi — 5 bộ phát hiện

Tự động tối ưu — Self-Optimizing Engine

Học từ thời gian

Cài đặt (2 phút)

Yêu cầu

Cách 1: Một lệnh duy nhất

Cách 2: Clone + script

Cách 3: Thủ công

Kết nối với AI Platform

Bắt đầu sử dụng

Bước 1 — Khởi tạo (chỉ 1 lần)

Bước 2 — Dùng hàng ngày

Danh sách Tools (16)

Khởi tạo

Tasks (5 tools)

Notes / Goals / Inbox (5 tools)

Knowledge Base (4 tools)

Insights & Analytics (1 tool)

Knowledge Base

Search ranking

Cấu hình .env

Cập nhật

Gỡ cài đặt

Scripts

macOS / Linux

Windows (PowerShell)

Chung

Kiến trúc

Kỹ thuật

Use Cases

Cho cá nhân

Cho team / doanh nghiệp

License

Как установить

Похожие MCP

GitHub

Supabase

Everything

Filesystem

Cấu hình `.env`