English Tutor MCP Server

🎓 ENGLISH TUTOR MCP SERVER - HƯỚNG DẪN SỬ DỤNG

📋 Tổng quan

Đây là một MCP (Model Context Protocol) Server được thiết kế để dạy tiếng Anh giao tiếp cho người Việt Nam, đặc biệt là trẻ em. Hệ thống được xây dựng dựa trên khung CEFR (Common European Framework of Reference for Languages).

🎯 Đặc điểm nổi bật

✨ Cấu trúc dữ liệu đầy đủ theo yêu cầu:

• Từ vựng chi tiết: Mỗi từ có phiên âm, nghĩa tiếng Việt, và câu ví dụ song ngữ
• Câu hỏi dẫn dắt: 8-10 câu hỏi để duy trì hội thoại tự nhiên
• Đoạn văn mẫu: 3 mức độ (basic, intermediate, advanced) với bản dịch
• Tình huống đóng vai: Chi tiết bối cảnh, vai trò, mục tiêu và câu mở đầu

🎓 Hỗ trợ đa cấp độ CEFR:

• A1 (Beginner): FAMILY, PETS, COLORS
• A2 (Elementary): SHOPPING, và nhiều chủ đề khác
• B1 (Intermediate): TRAVEL, và nhiều chủ đề khác
• Dễ dàng mở rộng thêm cấp độ B2, C1, C2

🛠️ Công cụ (Tools) đầy đủ:

1. list_all_topics(level) - Liệt kê tất cả chủ đề theo cấp độ
2. get_topic_vocabulary(level, topic) - Lấy từ vựng chủ đề
3. get_guiding_questions(level, topic) - Lấy câu hỏi dẫn dắt
4. get_sample_paragraphs(level, topic) - Lấy đoạn văn mẫu
5. get_role_play_scenarios(level, topic) - Lấy tình huống đóng vai
6. start_conversation(level, topic) - Bắt đầu buổi học
7. correct_grammar_pro(student_text) - Kiểm tra ngữ pháp
8. evaluate_response(student_response, topic, level) - Đánh giá câu trả lời
9. pronunciation_tips(word_or_phrase) - Gợi ý phát âm

📚 Cấu trúc dữ liệu mẫu

Ví dụ một chủ đề hoàn chỉnh (FAMILY - Cấp A1):

"FAMILY": {
    "topic_name": "FAMILY (GIA ĐÌNH)",
    
    # 1. Bộ từ vựng
    "vocabulary": [
        {
            "word": "Mother",
            "phonetic": "/ˈmʌðər/",
            "meaning": "Mẹ",
            "example": "My mother is a teacher.",
            "example_vi": "Mẹ tôi là giáo viên."
        },
        # ... 10+ từ vựng
    ],
    
    # 2. Câu hỏi dẫn dắt
    "guiding_questions": [
        {
            "question": "How many people are there in your family?",
            "question_vi": "Gia đình bạn có bao nhiêu người?"
        },
        # ... 8-10 câu hỏi
    ],
    
    # 3. Đoạn văn mẫu
    "sample_paragraphs": [
        {
            "level": "basic",
            "text": "My name is Mai. I am 8 years old...",
            "text_vi": "Tên tôi là Mai. Tôi 8 tuổi..."
        },
        # ... 2-3 đoạn văn
    ],
    
    # 4. Tình huống đóng vai
    "role_play_scenarios": [
        {
            "scenario_name": "Giới thiệu gia đình với bạn mới",
            "context": "Học viên đang giới thiệu...",
            "ai_role": "Bạn học mới...",
            "student_role": "Giới thiệu về các thành viên...",
            "goal": "Luyện tập nói về số lượng...",
            "opening_line": "Hi! I'm new here...",
            "opening_line_vi": "Chào bạn! Mình là học sinh mới..."
        },
        # ... 3-5 tình huống
    ]
}

🚀 Quy trình dạy học

Bước 1: Xác định trình độ và chủ đề

# AI hỏi trình độ học viên
# Sau đó gọi:
list_all_topics(level="A1")

# Học viên chọn chủ đề, AI gọi:
start_conversation(level="A1", topic="FAMILY")

Bước 2: Cung cấp tài liệu

# Khi học viên cần từ vựng:
get_topic_vocabulary(level="A1", topic="FAMILY")

# Khi cần câu hỏi thêm:
get_guiding_questions(level="A1", topic="FAMILY")

# Khi cần tham khảo mẫu:
get_sample_paragraphs(level="A1", topic="FAMILY")

# Khi đóng vai:
get_role_play_scenarios(level="A1", topic="FAMILY")

Bước 3: Kiểm tra và đánh giá

# 1. LUÔN kiểm tra ngữ pháp trước
result = correct_grammar_pro("There is 4 people in my family")

# 2. Nếu có lỗi (total_errors > 0):
#    - Giải thích lỗi
#    - Yêu cầu sửa lại
#    - KHÔNG đánh giá

# 3. Nếu không có lỗi (total_errors == 0):
evaluate_response(
    student_response="There are 4 people in my family",
    expected_topic="FAMILY",
    level="A1"
)

# 4. Nếu học viên hỏi về phát âm:
pronunciation_tips("mother")

📝 Cách thêm chủ đề mới

Bước 1: Chọn cấp độ và tên chủ đề

# Ví dụ: Thêm chủ đề FOOD vào cấp độ A1
"A1": {
    "FOOD": {
        # ... nội dung
    }
}

Bước 2: Điền đầy đủ 4 phần

1. Vocabulary (10-15 từ)

"vocabulary": [
    {
        "word": "Apple",
        "phonetic": "/ˈæpl/",
        "meaning": "Táo",
        "example": "I eat an apple every day.",
        "example_vi": "Tôi ăn một quả táo mỗi ngày."
    },
    # ... thêm từ vựng
]

2. Guiding Questions (8-10 câu)

"guiding_questions": [
    {
        "question": "What is your favorite food?",
        "question_vi": "Món ăn yêu thích của bạn là gì?"
    },
    # ... thêm câu hỏi
]

3. Sample Paragraphs (3 mức độ)

"sample_paragraphs": [
    {
        "level": "basic",
        "text": "I like pizza. Pizza is delicious...",
        "text_vi": "Tôi thích pizza. Pizza rất ngon..."
    },
    {
        "level": "intermediate",
        "text": "My favorite