mcp4xiaozhi
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
🕰️ 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: vnstock-mcp
🚀 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 mcp4xiaozhiBước 2: Tạo môi trường ảo
python3 -m venv mcp4xiaozhi_env
source mcp4xiaozhi_env/bin/activateBước 3: Cài đặt thư viện
pip install -r requirements.txtBướ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.commandKế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ị)
Double-click vào file
MCP4XIAOZHI.commandtrên DesktopCử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:
Đăng nhập https://xiaozhi.me/dashboard
Copy MCP Endpoint URL (có dạng
wss://api.xiaozhi.me/mcp/?token=...)Dán vào ô "MCP Endpoint"
Bấm "Kết nối"
Đợ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:
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
Bấm "Chọn File" → chọn file Excel
Bấm "Upload" → File sẽ được:
Copy vào thư mục project với tên
lich_lam_viec.xlsxHiể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
Token hết hạn
Lấy token mới từ https://xiaozhi.me/dashboard
❌ 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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Web and URL utilities over MCP: shorten URLs, screenshot pages, read page metadata, encode URLs.
Wikifeed MCP — wraps Wikimedia Feed API (free, no auth)
Uselessfacts MCP — wraps uselessfacts.jsph.pl API (free, no auth)
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with VnExpress news content through RSS feeds, advanced search with filters, and clean article text extraction for Vietnamese news consumption.10 npmMIT
- AlicenseNot gradedqualityDmaintenanceUnofficial MCP server providing Vietnamese stock market financial data, enabling natural language interaction with Claude Desktop.29 PyPIMIT
- FlicenseNot gradedqualityDmaintenanceEnables fetching latest news from VnExpress.net, including categories, search, and article content retrieval.-
- FlicenseNot gradedqualityDmaintenanceEnables crawling news articles by category (politics, economy, society, etc.) and generates blog-ready markdown summaries. Provides MCP tools for listing categories, crawling news, getting article details, and saving to files.-