iflow-mcp_vdlaptrinh-mcp-history

# 🕰️ MCP-History for XiaoZhi AI **MCP-History** là một **Model Context Protocol (MCP) skill** giúp **XiaoZhi AI** (hoặc **ChatGPT có hỗ trợ MCP**) tra cứu sự kiện lịch sử **“Ngày này năm xưa”**. Dự án được viết bằng **Python 3**, có thể chạy độc lập hoặc kết nối với **MCP endpoint** như `wss://api.xiaozhi.me/mcp...`. --- ## ⚡ Quick Start Chạy 3 lệnh sau để bắt đầu ngay (Linux / Raspberry Pi): ```bash git clone https://github.com/vdlaptrinh/mcp-history.git cd mcp-history ./quickstart.sh ``` 💡 Nếu không có file quickstart.sh, bạn có thể làm thủ công theo hướng dẫn bên dưới. ## ✨ Tính năng 📅 Lấy sự kiện lịch sử nổi bật trong ngày (theo ngày & tháng hiện tại). 🌐 Kết nối tới máy chủ MCP qua WebSocket (MCP_ENDPOINT). 🤖 Tích hợp dễ dàng với XiaoZhi AI hoặc ChatGPT MCP Developer Mode. ## 🧩 Viết gọn gàng bằng Python, dễ mở rộng và tùy chỉnh. 💻 Hỗ trợ Linux, macOS, Windows và Raspberry Pi. ## 🧩 Cài đặt từng bước 1️⃣ Clone dự án ``` git clone https://github.com/vdlaptrinh/mcp-history.git cd mcp-history/ ``` 2️⃣ Tạo môi trường ảo Python ``` python3 -m venv mcp_history_env source mcp_history_env/bin/activate ``` 💡 Trên Windows: ``` mcp_history_env\Scripts\activate ``` 3️⃣ Cài thư viện phụ thuộc ``` pip install -r requirements.txt ``` 4️⃣ Cấu hình endpoint MCP Thiết lập URL endpoint để kết nối tới máy chủ MCP: ``` export MCP_ENDPOINT=wss://api.xiaozhi.me/mcp... ``` ⚠️ Nếu dùng Windows PowerShell: powershell ``` setx MCP_ENDPOINT "wss://api.xiaozhi.me/mcp..." ``` 🚀 Chạy MCP Skill ``` python mcp_pipe.py /home/pi/mcp-history/server.py ``` ✅ Thay /home/pi/mcp-history/server.py bằng đường dẫn thực tế trên máy bạn. ## 🧠 Ví dụ kết quả Khi khởi chạy thành công, log sẽ hiển thị: ``` [MCP] Connected to wss://api.xiaozhi.me/mcp... [MCP] Registered skill: NgayNayNamXua ``` Khi được gọi qua XiaoZhi AI hoặc ChatGPT, tool history_today sẽ trả về: 📜 Ngày này năm xưa: - 1492: Christopher Columbus khám phá châu Mỹ - 1968: NASA phóng Apollo 7 - 2006: Google mua lại Y…