🕰️ XiaoZhi AI的MCP历史
MCP-历史 那是其中之一 模型上下文协议（MCP）技能 帮助 小智AI （或者 ChatGPT是否支持MCP（注：MCP在此处可能指某种特定功能、协议或系统，但具体含义需根据上下文确定，以下为直译）查询历史事件 “Ngày này năm xưa”翻译成中文是“往年今日”或“往年这一天”。。\ 该项目是用（某种语言）编写的 Python 3可以独立运行或连接到 MCP端点 “như”在越南语中翻译成中文是“像”或“如同”。 wss://api.xiaozhi.me/mcp...。
______________________________________________________________________
⚡ 快速入门
运行以下三条命令立即开始（Linux/Raspberry Pi）：
git clone https://github.com/vdlaptrinh/mcp-history.git
cd mcp-history
./quickstart.sh💡 如果没有 quickstart.sh 文件，您可以按照下面的指南手动操作。
✨ 功能
📅 获取当天（根据当前日期和月份）的突出历史事件。
🌐 通过WebSocket连接到MCP服务器（MCP_ENDPOINT）。
🤖 轻松集成至XiaoZhi AI或ChatGPT的MCP开发者模式。
🧩 用Python编写，结构清晰，易于扩展和定制。
支持Linux、macOS、Windows和Raspberry Pi。
🧩 步骤安装
1️⃣ 克隆项目
git clone https://github.com/vdlaptrinh/mcp-history.git
cd mcp-history/2️⃣ 创建Python虚拟环境
python3 -m venv mcp_history_env
source mcp_history_env/bin/activate💡 在Windows上：
mcp_history_env\Scripts\activate3️⃣ 安装依赖库
pip install -r requirements.txt4️⃣ 配置MCP终端节点 设置URL终端点以连接到MCP服务器：
export MCP_ENDPOINT=wss://api.xiaozhi.me/mcp...⚠️ 如果使用 Windows PowerShell：
PowerShell
setx MCP_ENDPOINT "wss://api.xiaozhi.me/mcp..."🚀 运行MCP技能
python mcp_pipe.py /home/pi/mcp-history/server.py✅ 将 /home/pi/mcp-history/server.py 替换为您机器上的实际路径。
🧠 示例结果
启动成功后，日志将显示：
[MCP] Connected to wss://api.xiaozhi.me/mcp...
[MCP] Registered skill: NgayNayNamXua当通过小智AI或ChatGPT被调用时，\history_today\工具将返回：
📜 往日今昔：
- 1492年：克里斯托弗·哥伦布发现美洲
- 1968年：美国国家航空航天局发射阿波罗7号
- 2006年：谷歌收购YouTube
📂 文件夹结构
mcp-history/
│
├── server.py # MCP skill chính (Ngày này năm xưa)
├── mcp_pipe.py # Trình kết nối tới MCP endpoint
├── requirements.txt # Danh sách thư viện cần thiết
├── README.md # Tài liệu hướng dẫn
└── index.json # Metadata mô tả skill (tùy chọn)🧾 index.json（可选） 这个文件帮助为MCP客户端（如ChatGPT或小智）描述技能：
{
"name": "NgayNayNamXua",
"description": "Trả về các sự kiện lịch sử nổi bật trong ngày hôm nay.",
"tools": [
{
"name": "history_today",
"description": "Lấy danh sách các sự kiện 'ngày này năm xưa'.",
"input_schema": { "type": "object", "properties": {} }
}
]
}💡 扩展提示
你可以：
🔌 添加其他工具（例如：“今日新闻”，“当前天气”）。
🧠 将多个MCP技能组合成智能工具集。
🕹️ 创建UI来显示事件或通过Telegram/Discord发送。
📦 封装成Docker容器以便在云端运行。
🧑💻 作者
VD 编程 📘 GitHub：@vdlaptrinh（可译为“GitHub账号：@vdlaptrinh”或保持原样，根据语境判断是否需要具体翻译用户名） 🌐 网站：https://vdlaptrinh.github.io 💬 邮箱：contact@vdlaptrinh.com
许可证
根据MIT许可证发布。 你被允许自由使用、修改、分发，条件是必须注明来源。
🧩 MCP-History – XiaoZhi AI生态中一个虽小但功能强大的扩展模块。
自动执行：
激活虚拟环境 mcp_history_env
设置端点 MCP_ENDPOINT
运行 mcp_pipe.py 连接至 server.py
使用 systemd 启动系统
1️⃣ 编写启动脚本
创建文件：
sudo nano /home/pi/start_mcp_history.sh添加以下内容：
#!/bin/bash
# === Script khởi động MCP-History ===
# Chờ hệ thống ổn định mạng (quan trọng để kết nối wss)
sleep 10
# Kích hoạt môi trường ảo
source /home/pi/mcp-history/mcp_history_env/bin/activate
# Thiết lập endpoint MCP
export MCP_ENDPOINT=wss://api.xiaozhi.me/...
# Chuyển đến thư mục dự án
cd /home/pi/mcp-history
# Ghi log để dễ kiểm tra
echo "=== MCP-History started at $(date) ===" >> /home/pi/mcp-history/mcp_history.log
# Chạy chương trình (server + pipe)
python3 mcp_pipe.py server.py >> /home/pi/mcp-history/mcp_history.log 2>&1保存（Ctrl + O，回车，Ctrl + X），然后授予执行权限：
sudo chmod +x /home/pi/start_mcp_history.sh⚙️ 2️⃣ 创建 systemd 服务文件
创建服务：
sudo nano /etc/systemd/system/mcp_history.service添加以下内容：
[Unit]
Description=MCP-History Skill for XiaoZhi AI
After=network.target
[Service]
Type=simple
User=pi
WorkingDirectory=/home/pi/mcp-history
ExecStart=/home/pi/start_mcp_history.sh
Restart=always
RestartSec=5
StandardOutput=append:/home/pi/mcp-history/mcp_history.log
StandardError=append:/home/pi/mcp-history/mcp_history.log
Environment="MCP_ENDPOINT=wss://api.xiaozhi.me/..."
[Install]
WantedBy=multi-user.target保存并退出。
🚀 3️⃣ 启用并启动服务
运行以下命令：
sudo systemctl daemon-reload
sudo systemctl enable mcp_history.service
sudo systemctl start mcp_history.service检查状态：
sudo systemctl status mcp_history.service 翻译为中文是：“以sudo权限查看mcp_history.service服务的状态”
🧩 4️⃣ 检查活动日志
查看MCP历史日志：
tail -f /home/pi/mcp-history/mcp_history.log✅ 5️⃣ 重启后自动启动
从现在起，每次Raspberry Pi启动时，它都会自动：
激活环境变量 mcp_history_env
连接到 wss://api.xiaozhi.me/mcp-history
运行 mcp_pipe.py + server.py
将日志记录到 /home/pi/mcp-history/mcp_history.log