{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_p6kxxu77r7b6","handle":"iflow-mcp-vdlaptrinh-mcp-history","url":"https://wellknown.network/agents/iflow-mcp-vdlaptrinh-mcp-history","links":{"self":"https://wellknown.network/agents/iflow-mcp-vdlaptrinh-mcp-history/record.json","html":"https://wellknown.network/agents/iflow-mcp-vdlaptrinh-mcp-history","markdown":"https://wellknown.network/agents/iflow-mcp-vdlaptrinh-mcp-history/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-vdlaptrinh-mcp-history","status":"https://wellknown.network/api/v1/agents/iflow-mcp-vdlaptrinh-mcp-history/status","claim":"https://wellknown.network/agents/iflow-mcp-vdlaptrinh-mcp-history/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-vdlaptrinh-mcp-history/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-vdlaptrinh-mcp-history/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-vdlaptrinh-mcp-history/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-vdlaptrinh-mcp-history/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-vdlaptrinh-mcp-history","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_vdlaptrinh-mcp-history","summary":"MCP skill for retrieving 'Ngày này năm xưa' (historical events) from lichngaytot.com","description":"# 🕰️ MCP-History for XiaoZhi AI\n\n**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”**.  \nDự á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...`.\n\n---\n\n## ⚡ Quick Start\n\nChạy 3 lệnh sau để bắt đầu ngay (Linux / Raspberry Pi):\n\n```bash\ngit clone https://github.com/vdlaptrinh/mcp-history.git\ncd mcp-history\n./quickstart.sh\n```\n💡 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.\n\n## ✨ Tính năng\n📅 Lấy sự kiện lịch sử nổi bật trong ngày (theo ngày & tháng hiện tại).\n\n🌐 Kết nối tới máy chủ MCP qua WebSocket (MCP_ENDPOINT).\n\n🤖 Tích hợp dễ dàng với XiaoZhi AI hoặc ChatGPT MCP Developer Mode.\n\n## 🧩 Viết gọn gàng bằng Python, dễ mở rộng và tùy chỉnh.\n\n💻 Hỗ trợ Linux, macOS, Windows và Raspberry Pi.\n\n## 🧩 Cài đặt từng bước\n1️⃣ Clone dự án\n```\ngit clone https://github.com/vdlaptrinh/mcp-history.git\ncd mcp-history/\n```\n2️⃣ Tạo môi trường ảo Python\n```\npython3 -m venv mcp_history_env\nsource mcp_history_env/bin/activate\n```\n💡 Trên Windows:\n\n```\nmcp_history_env\\Scripts\\activate\n```\n3️⃣ Cài thư viện phụ thuộc\n```\npip install -r requirements.txt\n```\n4️⃣ Cấu hình endpoint MCP\nThiết lập URL endpoint để kết nối tới máy chủ MCP:\n\n```\nexport MCP_ENDPOINT=wss://api.xiaozhi.me/mcp...\n```\n⚠️ Nếu dùng Windows PowerShell:\n\npowershell\n```\nsetx MCP_ENDPOINT \"wss://api.xiaozhi.me/mcp...\"\n```\n🚀 Chạy MCP Skill\n```\npython mcp_pipe.py /home/pi/mcp-history/server.py\n```\n✅ Thay /home/pi/mcp-history/server.py bằng đường dẫn thực tế trên máy bạn.\n\n## 🧠 Ví dụ kết quả\nKhi khởi chạy thành công, log sẽ hiển thị:\n\n```\n[MCP] Connected to wss://api.xiaozhi.me/mcp...\n[MCP] Registered skill: NgayNayNamXua\n```\nKhi được gọi qua XiaoZhi AI hoặc ChatGPT, tool history_today sẽ trả về:\n\n📜 Ngày này năm xưa:\n- 1492: Christopher Columbus khám phá châu Mỹ\n- 1968: NASA phóng Apollo 7\n- 2006: Google mua lại Y…","publisher":null,"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_vdlaptrinh-mcp-history","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_vdlaptrinh-mcp-history","registry":"pypi","observedAt":"2026-09-15T20:21:33.751Z","publishedAt":"2026-02-06T20:45:30.787481Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_vdlaptrinh-mcp-history","url":"https://pypi.org/project/iflow-mcp_vdlaptrinh-mcp-history/","firstSeenAt":"2026-09-09T21:24:44.491Z","fetchedAt":"2026-09-15T20:20:27.287Z","normalizedAt":"2026-09-15T20:20:27.287Z"}]},"firstSeenAt":"2026-09-09T21:24:44.491Z","updatedAt":"2026-09-15T20:21:33.751Z"}