🕰️ MCP-History for XiaoZhi AI

MCP-History 是一个 Model Context Protocol (MCP) 技能，帮助 XiaoZhi AI（或支持MCP的ChatGPT）查询历史事件 “今天的历史”。
该项目用 Python 3 编写，可以独立运行或连接到 MCP 端点 如 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\activate

3️⃣ 安装依赖库

pip install -r requirements.txt

4️⃣ 配置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] 已连接到 wss://api.xiaozhi.me/mcp...
[MCP] 注册技能：NgayNayNamXua

当通过XiaoZhi AI或ChatGPT调用时，history_today工具将返回：

📜 今天的历史：

• 1492年：克里斯托弗·哥伦布发现美洲
• 1968年：NASA发射阿波罗7号
• 2006年：Google收购YouTube

📂 目录结构

mcp-history/
│
├── server.py           # 主要的MCP技能（今天的历史）
├── mcp_pipe.py         # 连接到MCP端点的程序
├── requirements.txt    # 所需库的列表
├── README.md           # 指南文档
└── index.json          # 描述技能的元数据（可选）

🧾 index.json（可选） 此文件用于向MCP客户端（如ChatGPT或XiaoZhi）描述技能：

{
  "name": "NgayNayNamXua",
  "description": "返回今天的重大历史事件。",
  "tools": [
    {
      "name": "history_today",
      "description": "获取'今天的历史'事件列表。",
      "input_schema": { "type": "object", "properties": {} }
    }
  ]
}

💡 扩展建议

您可以：

🔌 添加其他工具（例如：“今日新闻”，“当前天气”）。

🧠 将多个MCP技能组合成智能工具包。

🕹️ 创建UI来显示事件或发送到Telegram / Discord。

📦 打包成Docker容器以在云中运行。

🧑‍💻 作者

VD Lập Trình 📘 GitHub: @vdlaptrinh 🌐 网站: https://vdlaptrinh.github.io 💬 邮箱: contact@vdlaptrinh.com

许可证

发布在MIT许可证下。 您可以自由使用、修改和分发，但必须注明原始来源。

🧩 MCP-History – 一个小而强大的XiaoZhi AI生态系统扩展。

自动执行：

激活虚拟环境mcp_history_env

设置endpoint MCP_ENDPOINT

运行mcp_pipe.py连接到server.py

通过systemd与系统一起启动

1️⃣ 编写启动脚本

创建文件：

sudo nano /home/pi/start_mcp_history.sh

添加以下内容：

#!/bin/bash
# === MCP-History 启动脚本 ===

# 等待网络稳定（重要以确保wss连接）
sleep 10

# 激活虚拟环境
source /home/pi/mcp-history/mcp_history_env/bin/activate

# 设置MCP端点
export MCP_ENDPOINT=wss://api.xiaozhi.me/...

# 转到项目目录
cd /home/pi/mcp-history

# 记录日志以便检查
echo "=== MCP-History 启动于 $(date) ===" >> /home/pi/mcp-history/mcp_history.log

# 运行程序（服务器+管道）
python3 mcp_pipe.py server.py >> /home/pi/mcp-history/mcp_history.log 2>&1

保存（Ctrl + O, Enter, Ctrl + X），然后赋予执行权限：

sudo chmod +x /home/pi/start_mcp_history.sh

⚙️ 2️⃣ 创建systemd服务文件

创建服务：

sudo nano /etc/systemd/system/mcp_history.service

添加以下内容：

[Unit]
Description=XiaoZhi AI的MCP-History技能
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

🧩 4️⃣ 查看活动日志

查看MCP-History日志：

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