Skip to main content
Glama
vdlaptrinh

mcp4xiaozhi

by vdlaptrinh
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

🕰️ MCP4XIAOZHI - MCP Tools for XiaoZhi AI

MCP4XIAOZHI là bộ công cụ MCP cho XiaoZhi AI và ChatGPT, bao gồm:

  • 📅 ngay_nay_nam_xua - Sự kiện lịch sử "Ngày này năm xưa"

  • 📰 tin_tuc_vnexpress - Tin tức mới nhất từ VNExpress

  • 📖 truyen_ngu_ngon - Câu chuyện ngắn hay

  • 📅 lich_cong_tac - Lịch công tác tuần từ Excel

📋 Yêu cầu

  • macOS (MacBook)

  • Python 3.10+

  • Git

Related MCP server: News MCP Server for VnExpress

🚀 Cài đặt trên MacBook MỚI

Bước 1: Clone dự án

Mở Terminal và chạy:

cd ~/Downloads
git clone https://github.com/vdlaptrinh/mcp4xiaozhi.git
cd mcp4xiaozhi

Bước 2: Tạo môi trường ảo

python3 -m venv mcp4xiaozhi_env
source mcp4xiaozhi_env/bin/activate

Bước 3: Cài đặt thư viện

pip install -r requirements.txt

Bước 4: Tạo shortcut trên Desktop

# Tạo file shortcut
echo '#!/bin/bash
cd /Users/dailuu/mcp4xiaozhi
source mcp4xiaozhi_env/bin/activate
python3 gui.py' > ~/Desktop/MCP4XIAOZHI.command

# Cấp quyền chạy
chmod +x ~/Desktop/MCP4XIAOZHI.command

Kết quả: File MCP4XIAOZHI.command sẽ xuất hiện trên Desktop.

🎯 Cách sử dụng

Cách 1: Chạy từ Desktop (Khuyến nghị)

  1. Double-click vào file MCP4XIAOZHI.command trên Desktop

  2. Cửa sổ MCP-CHATBOT-AI hiện ra

Cách 2: Chạy từ Terminal

cd ~/mcp4xiaozhi
source mcp4xiaozhi_env/bin/activate
python3 gui.py

📱 Hướng dẫn sử dụng GUI

1. Kết nối MCP Endpoint

┌─────────────────────────────────────────┐
│ MCP-CHATBOT-AI                        │
├─────────────────────────────────────────┤
│ MCP Endpoint: [________________] [Kết nối] │
│ Trạng thái: Chưa kết nối             │
│                                         │
│ MCP Endpoint lần cuối: [_____________] [Use]  │
│                                         │
│ Upload File: [_____________] [Chọn] [Upload] │
│                                         │
│ Log kết nối:                           │
│ [                                     ] │
│ [                                     ] │
└─────────────────────────────────────────┘

Các bước:

  1. Đăng nhập https://xiaozhi.me/dashboard

  2. Copy MCP Endpoint URL (có dạng wss://api.xiaozhi.me/mcp/?token=...)

  3. Dán vào ô "MCP Endpoint"

  4. Bấm "Kết nối"

  5. Đợi hiện thông báo "Đã kết nối"

2. Upload file lịch công tác

Khi cần cập nhật lịch tuần mới:

  1. Chuẩn bị file Excel với 6 cột:

    • THỨ NGÀY

    • THỜI GIAN

    • NỘI DUNG CÔNG VIỆC

    • CHỦ TRÌ

    • ĐỊA ĐIỂM

    • THÀNH PHẦN

  2. Bấm "Chọn File" → chọn file Excel

  3. Bấm "Upload" → File sẽ được:

    • Copy vào thư mục project với tên lich_lam_viec.xlsx

    • Hiển thị thông tin file trong log

❓ Cách hỏi MCP Tools (trên XiaoZhi AI)

ngay_nay_nam_xua

User: Ngày này năm xưa hôm nay là gì?
Bot: 📜 Sự kiện 24-4:
    - 1320: Vua Trần Anh Tông...
    - 1931: ...

tin_tuc_vnexpress

User: Tin tức mới nhất hôm nay?
Bot: 📰 Tin mới nhất từ VNExpress:
    1. Chủ tịch Vietcombank...
    2. VN-Index mất hơn...

truyen_ngu_ngon

User: Kể cho tôi một câu chuyện hay
Bot: 📖 Câu chuyện:
    1. Quý bà và người ăn mày...

lich_cong_tac

User: Lịch thứ hai tuần này?
Bot: 📅 Hai 20/4:
    7h00: Chào cờ...

🔧 Khắc phục lỗi

❌ Lỗi "Python not found"

# Kiểm tra Python
which python3
# Nếu không có, cài đặt:
brew install python3

❌ Lỗi SSL Certificate

Đã có sẵn fix trong mcp_pipe.py

❌ Lỗi 401 Unauthorized

❌ Lỗi "File không tồn tại"

Đảm bảo file lich_lam_viec.xlsx đúng định dạng 6 cột

📂 Cấu trúc file

mcp4xiaozhi/
├── server.py           # MCP server (4 tools)
├── mcp_pipe.py         # Kết nối WebSocket
├── gui.py              # Giao diện GUI
├── mcp_config.json    # Cấu hình MCP
├── requirements.txt   # Thư viện Python
├── lich_lam_viec.xlsx  # Lịch công tác
└── README.md         # Tài liệu này

📜 Giấy phép

MIT License - Tự do sử dụng và phân phối.

🧑‍💻 Tác giả

VD Lập Trình - https://vdlaptrinh.github.io

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers