MCPaeroedu — AeroEdu MCP Server

MCP server cho inphysic.com — kết nối Claude · DeepSeek · GPT · Codex · Gemini với nền tảng AeroEduVision. Sinh đề, quản lý khoá học, query Knowledge Graph, chấm bài — tất cả qua prompt tự nhiên trong client AI bạn yêu thích.

Hỗ trợ chính thức: Claude Desktop · Cursor · Cherry Studio · Cline · 5ire

---

🚀 Cài đặt nhanh (3 phút)

Cách A — Tải bản đóng gói (KHUYẾN NGHỊ — không cần git/npm)

Tải zip 5.3 MB cho hệ điều hành của bạn:

• 🍎 macOS / Linux (5.3 MB)
• 🪟 Windows (5.3 MB)

Yêu cầu: Node.js ≥ 18 (tải nodejs.org).

Cách B — Build từ source (cho dev)

git clone https://github.com/aerovfx/MCPaeroedu.git
cd MCPaeroedu
npm install
npm run build

---

🔑 Setup API Key

1. Đăng nhập inphysic.com/teacher/api-keys
2. Bấm "+ Tạo API Key mới" → đặt tên (vd "Claude MacBook")
3. ⚠️ Copy ngay chuỗi AERO-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx (chỉ hiện 1 lần)

---

⚙️ Cấu hình client AI

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "aeroedu": {
      "command": "/path/to/aeroedu-mcp/bin/aeroedu-mcp",
      "env": {
        "AEROEDU_API_KEY": "AERO-your-key-here"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

Cùng format JSON như Claude Desktop. Sau đó vào Settings → Models → Custom OpenAI Endpoint:

• Base URL: https://api.deepseek.com/v1
• Model: deepseek-chat hoặc deepseek-reasoner

Cherry Studio (GUI desktop)

Settings → MCP Servers → + Add:

• Name: aeroedu
• Type: STDIO
• Command: /path/to/aeroedu-mcp/bin/aeroedu-mcp
• Env: AEROEDU_API_KEY = AERO-...

Cline (VS Code extension)

Cline panel → MCP Servers → Configure MCP Servers → cùng JSON format.

Windows path

Thay /path/to/aeroedu-mcp/bin/aeroedu-mcp bằng C:\\path\\to\\aeroedu-mcp\\bin\\aeroedu-mcp.cmd.

---

🛠 24 MCP Tools

Course (5)

• aeroedu_course_list — list khoá học
• aeroedu_course_create — tạo khoá mới
• aeroedu_course_detail — chi tiết khoá
• aeroedu_course_update — cập nhật
• aeroedu_course_delete — xoá

Knowledge Graph (5)

• aeroedu_kg_search — tìm node theo query
• aeroedu_kg_node — chi tiết node
• aeroedu_kg_path — tìm đường giữa 2 node
• aeroedu_kg_visit — log visit + mastery
• aeroedu_kg_extract — trích xuất concept từ text

Block (4)

• aeroedu_block_create_video — tạo video block
• aeroedu_block_create_pdf — tạo PDF block
• aeroedu_block_create_quiz — tạo quiz block
• aeroedu_block_create_lab — tạo lab block

Exam & Question (5)

• aeroedu_exam_publish — publish đề
• aeroedu_question_add — thêm câu hỏi vào bank
• aeroedu_student_list — list HS
• aeroedu_report_xp — báo cáo XP
• aeroedu_report_progress — tiến độ HS

DaVinci Resolve (5)

• aeroedu_davinci_* — video timeline ops (cần DaVinci Resolve cài local)

---

🧪 Ví dụ prompt

"Tạo cho tôi 1 đề thi Vật lí 11 chương Dao động cơ —
 10 câu MCQ, độ khó trung bình, có lời giải"

→ AI gọi aeroedu_exam_publish → Đề xuất hiện trong /teacher/exams ✓

"Liệt kê 5 khoá học gần nhất của tôi"

→ aeroedu_course_list → bảng 5 khoá + ID + status

"Tìm node 'Định luật bảo toàn năng lượng' trong KG Vật lí"

→ aeroedu_kg_search → metadata + path tới node

---

🔐 Bảo mật

• API Key hash bcrypt, chỉ stored prefix trên client. Server không bao giờ thấy raw key.
• JWT mint sau validate-key, expire 90d (ignoreExpiration enabled trên server).
• Audit log mỗi tool call vào ~/.aeroedu-mcp/audit-YYYY-MM-DD.jsonl.
• Revoke key bất kỳ lúc nào ở /teacher/api-keys.

---

📦 Build & Release

npm install              # cài deps
npm run build            # tsc → dist/
npm run dev              # watch mode (tsx)
npm run pack:release     # build zip cho Mac + Win → releases/

Output: releases/aeroedu-mcp-vX.Y.Z-{mac,win}.zip (mỗi 5.3 MB)

Upload public:

gsutil cp releases/aeroedu-mcp-v*-{mac,win}.zip \
  gs://aeroedu-media-extreme-lattice-491123-p2/mcp/

---

🌐 Tài nguyên

• Website: inphysic.com
• Hướng dẫn cài đặt full: inphysic.com/teacher/api-keys
• API Key Dashboard: inphysic.com/teacher/api-keys
• MCP Spec: modelcontextprotocol.io
• Source main monorepo: aerovfx/aeroeduvision

---

📜 License

MIT — Copyright (c) 2026 AeroEduVision

---

🐛 Issues

Báo lỗi hoặc đề xuất tại: GitHub Issues

Hoặc email: support@inphysic.com