Bắt đầu
Cài đặt và chạy Aki MCP Server
Không app desktop, không khóa thiết bị: một lệnh npm, hoặc clone và chạy từ mã nguồn. Chỉ mất vài phút.
Yêu cầu trước
- Node.js 22 trở lên, trên Windows, Linux hoặc macOS.
- Chỉ Windows: Git for Windows (hoặc WSL) trên
PATH, vì công cụ shell/search dùng các binary Unix. - Chỉ cho AI web từ xa: Tailscale đã cài và đăng nhập, bật Funnel một lần cho tailnet (miễn phí trên mọi gói). IDE local bỏ qua bước này — chúng dùng 127.0.0.1.
- Một AI client hỗ trợ custom MCP connector: Claude web, ChatGPT, Grok hoặc Postman.
Cách 1: CLI toàn cục (khuyên dùng)
Đã publish lên npm. Cài một lần, hoặc chạy ngay không cần cài.
# Cài một lần, chạy mọi lúc
npm install -g @akinet/akimcp
akimcp
# Hoặc chạy ngay, không cần cài
npx @akinet/akimcp
Cách 2: Clone và chạy từ mã nguồn
# Clone repo
git clone https://github.com/lacvietanh/aki-mcp-sv.git
cd aki-mcp-sv
# Cài đặt và chạy
npm install
npm start
npm start làm gì
- Tự bật Tailscale Funnel ở cổng 9999 khi cần.
- Sinh passphrase và khởi chạy gatekeeper (OAuth 2.1).
- Mở control panel local, nơi bạn đặt thư mục được phép và allowlist shell.
Đưa ra HTTPS (tùy chọn ingress)
Tailscale Funnel (mặc định)
Zero-config, tự bật cổng 9999. Miễn phí trên mọi gói Tailscale.
Cloudflare named tunnel
Chạy với --tunnel <cred.json> --origin <url> để đi qua tunnel riêng của bạn.
Dùng origin riêng
Đặt PUBLIC_ORIGIN=https://your-host để trỏ tới reverse proxy HTTPS riêng.
Chạy có an toàn không?
- Không cài gì vào hệ thống, không tạo daemon, không cần quyền sudo/administrator.
- Cấu hình và token nằm ở
~/.aki/mcpsv/. - Phần lớn allowlist shell mặc định chỉ-đọc; một số helper dev/OS có thể ghi, nên xem lại trên máy nhạy cảm.
- Đóng terminal sẽ dừng server; một tác vụ nền bạn đã chạy vẫn tiếp tục tới khi bạn dừng.
Xem đầy đủ mô hình bảo mật ở trang Bảo mật.