Skip to content

haituant/mcp-kit

v0.1.0

Private source repository for reusable MCP Kit skills. The first packaged skill compares TikTok Shop GMV Max performance by the same completed hours.

MCP Kit 🔒

Kho GitHub riêng tư để lưu trữ, quản lý phiên bản và phát triển các Skill AI của tôi.

Dự án tập hợp hướng dẫn (SKILL.md), mã xử lý, tài liệu tham khảo và cấu hình cần thiết. Mục tiêu lâu dài là sử dụng lại các Skill trên nhiều công cụ AI mà không phải quản lý nhiều bản sao thủ công.

Trạng thái hiện tại: Đã lưu mã nguồn Skill trên GitHub. Chưa triển khai MCP Hub chạy trực tuyến và chưa thiết lập tự đồng bộ với Plugin ChatGPT.

📚 Các Skill hiện có

SkillChức năngTrạng thái
TikTok Shop Hourly DashboardLấy dữ liệu GMV Max từ kết nối TikTok Ads MCP đang có; so sánh đơn hàng, chi phí, doanh thu và ROI theo cùng các giờ đã hoàn tất; hiển thị biểu đồ.Đã đưa mã nguồn lên GitHub
CapCut Retention SubtitlesTạo phụ đề giữ chân cao cấp cho CapCut PC (từ khóa vàng neon, font Phudu Bold, bố cục 1 dòng/2 tầng, SFX sync micro-giây, timeline liền mạch cho video ngắn TikTok/Reels).Đã đưa mã nguồn lên GitHub

Các Skill khác sẽ được bổ sung khi đã có đầy đủ mã nguồn và quyền sử dụng.

📁 Cấu trúc kho lưu trữ

plugin-ca-nhan/
├── skills/                      # 257 AI Skills
├── server/                      # MCP Server (Node.js/TypeScript)
│   ├── src/
│   ├── Dockerfile
│   └── package.json
├── docs/
│   ├── DEPLOY_VPS.md           # Hướng dẫn chi tiết triển khai lên VPS
│   └── MCP_SERVER.md
├── docker-compose.yml           # Khởi chạy VPS với 1 lệnh
├── .env.example                # Cấu hình mẫu cổng & Bearer token
├── .github/workflows/
│   └── validate.yml            # CI kiểm tra Python & Node.js
├── .gitignore
├── plugin.json
└── README.md

🚀 Triển khai nhanh lên VPS

Xem hướng dẫn chi tiết tại docs/DEPLOY_VPS.md.

# 1. Kéo mã nguồn về VPS
git clone https://github.com/haituanT/plugin-ca-nhan.git
cd plugin-ca-nhan

# 2. Cấu hình biến môi trường
cp .env.example .env

# 3. Khởi chạy bằng Docker Compose
docker compose up -d --build

Endpoint MCP: https://your-domain.com/mcp (hỗ trợ Bearer Token qua MCP_AUTH_TOKEN).

➕ Thêm hoặc cập nhật Skill

  1. Tạo thư mục skills/ten-skill/ hoặc sửa thư mục Skill đã tồn tại.
  2. Đặt SKILL.md trong thư mục đó; khai báo đúng name và description ở phần YAML đầu file.
  3. Giữ kèm các thư mục scripts/, references/, assets/ nếu Skill cần đến.
  4. Kiểm tra nội dung không có mật khẩu, token hoặc thông tin bí mật.
  5. Commit và push lên nhánh GitHub phù hợp. GitHub Actions sẽ kiểm tra cấu trúc Skill và chạy bộ kiểm thử hiện có.

Lưu ý quan trọng: Việc push lên GitHub chưa tự cài hoặc cập nhật Skill/Plugin trong ChatGPT. Để sử dụng cơ chế đó cần thiết lập thêm quy trình đóng gói, triển khai hoặc MCP Hub có xác thực.

🔐 Bảo mật và quyền truy cập

  • Giữ repository ở chế độ Private và chỉ cấp quyền cho người hoặc ứng dụng thực sự cần thiết.
  • Không đưa lên GitHub: mật khẩu, cookie đăng nhập, access token, refresh token, khóa API, khóa bí mật ứng dụng hoặc file chứa thông tin xác thực TikTok/Facebook.
  • .gitignore chỉ giúp tránh đưa nhầm một số tệp lên Git; vẫn cần rà soát các thay đổi trước khi commit.
  • Kho GitHub Private không thay thế kho lưu trữ bí mật. Nếu triển khai MCP Server, hãy lưu thông tin xác thực trong hệ thống quản lý bí mật phía máy chủ.
  • Mỗi tài khoản AI truy cập MCP Hub riêng nên được xác thực và phân quyền độc lập. Phiên đăng nhập TikTok/Facebook gắn với một tài khoản ChatGPT không mặc nhiên chuyển được sang tài khoản khác.

🚀 Kế hoạch phát triển tiếp theo

  1. Bổ sung các Skill khác vào cùng repository và kiểm tra tính tương thích.
  2. Thiết lập cơ chế phát hành/đồng bộ phiên bản Skill từ GitHub.
  3. Nếu cần sử dụng MCP ở nhiều tài khoản AI, triển khai MCP Hub riêng với địa chỉ HTTPS ổn định, xác thực truy cập và lưu token an toàn.
  4. Chỉ kết nối Plugin với MCP Hub sau khi xác minh máy chủ và quyền truy cập hoạt động đúng.

MCP Kit — một nơi quản lý Skill, cập nhật có kiểm soát, không công khai thông tin đăng nhập.