MCP-4-XIAOZHI - Hướng dẫn triển khai

Giới thiệu

MCP-History là bộ MCP tools gồm 3 công cụ:

• 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 ngẫu nhiên (23 câu chuyện)

Yêu cầu

• macOS
• Python 3.10+
• Git

Các bước triển khai

1. Clone dự án

git clone https://github.com/vdlaptrinh/mcp4xiaozhi.git
cd mcp-history

2. Tạo môi trường ảo và cài đặt

python3 -m venv mcp_history_env
source mcp_history_env/bin/activate
pip install -r requirements.txt

3. Cấu hình MCP Endpoint

Đăng nhập https://xiaozhi.me/dashboard để lấy MCP_ENDPOINT

Cách 1: Tạo file .env

echo 'MCP_ENDPOINT="wss://api.xiaozhi.me/mcp/?token=YOUR_TOKEN"' > .env

Cách 2: Export trực tiếp

export MCP_ENDPOINT="wss://api.xiaozhi.me/mcp/?token=YOUR_TOKEN"

4. Chạy ứng dụng

Cách A: Chạy GUI (Khuyến nghị)

python3 gui.py

Cách B: Chạy CLI

python3 mcp_pipe.py

5. Tạo shortcut trên Desktop

cat > ~/Desktop/MCP-History.command << 'EOF'
#!/bin/bash
cd /Users/dailuu/mcp-history
source mcp_history_env/bin/activate
python3 gui.py
EOF
chmod +x ~/Desktop/MCP-History.command

Double-click file MCP-History.command để mở ứng dụng.

Cấu trúc file

mcp-history/
├── server.py           # MCP server chính (3 tools)
├── mcp_pipe.py         # Trình kết nối WebSocket
├── gui.py              # Giao diện đồ họa
├── mcp_config.json     # Cấu hình MCP servers
├── requirements.txt   # Thư viện Python
└── .env                # Token MCP_ENDPOINT

MCP Tools

ngay_nay_nam_xua

ngay_nay_nam_xua(opt="TODAY")  # TODAY | YESTERDAY | TOMORROW

tin_tuc_vnexpress

tin_tuc_vnexpress(limit=10)  # Số tin muốn lấy (1-50)

truyen_ngu_ngon

truyen_ngu_ngon()  # Trả về 1 câu chuyện ngẫu nhiên

Khắc phục lỗi

Lỗi SSL Certificate

Nếu gặp lỗi SSL, đã có sẵn fix trong mcp_pipe.py.

Lỗi 401 Unauthorized

• Token hết hạn hoặc không hợp lệ
• Lấy token mới từ https://xiaozhi.me/dashboard

Lỗi "python not found"

Sửa mcp_config.json, thay python bằng python3:

{
  "mcpServers": {
    "mcp-history": {
      "command": "python3",
      "args": ["server.py"]
    }
  }
}

Tác giả

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