loading…
Search for a command to run...
loading…
A semantic search MCP server that provides historical question-and-answer capabilities using an embedding-based retrieval system. It connects to the XiaoZhi Age
A semantic search MCP server that provides historical question-and-answer capabilities using an embedding-based retrieval system. It connects to the XiaoZhi Agent via WebSockets to query a local SQLite history database.
Đây là một chatbot hỏi đáp về lịch sử sử dụng semantic search (tìm kiếm ngữ nghĩa) trên cơ sở dữ liệu câu hỏi – trả lời.
Hệ thống kết nối với XiaoZhi MCP Agent thông qua WebSocket, sau đó truy vấn cơ sở dữ liệu bằng embedding model để tìm câu trả lời phù hợp nhất.
Người dùng / XiaoZhi Agent
↓
Kết nối MCP (WebSocket)
↓
mcp_client.py
↓
Tìm kiếm ngữ nghĩa (FastEmbed / SentenceTransformer)
↓
SQLite Database
↓
Trả lời cho Agent
xiaozhi-mcp/
│
├── data.csv # Dữ liệu câu hỏi – trả lời lịch sử
├── data.txt # Dữ liệu văn bản (tùy chọn)
├── knowledge.db # Cơ sở dữ liệu SQLite
│
├── import.js # Import dữ liệu CSV vào database
├── reset.js # Reset database
│
├── server.js # Script Node.js hỗ trợ
├── package.json # Thông tin package Node.js
│
├── semantic_server.py # API server tìm kiếm ngữ nghĩa
├── mcp_client.py # Client kết nối MCP với XiaoZhi
│
├── node_modules
└── venv
Python 3.9 trở lên
Cài đặt thư viện:
pip install fastembed websockets numpy flask sentence-transformers
Node.js 18 trở lên
Cài đặt dependency:
npm install
Dữ liệu chatbot được lưu trong file data.csv.
Ví dụ:
question,answer
Chiến thắng Điện Biên Phủ diễn ra năm nào?,1954
Ai là người lãnh đạo cách mạng Việt Nam?,Hồ Chí Minh
Chiến tranh thế giới thứ hai kết thúc năm nào?,1945
Chạy lệnh:
node import.js
Script sẽ:
data.csvqaknowledge.dbCấu trúc bảng:
qa(
question TEXT,
answer TEXT
)
Nếu muốn xóa toàn bộ dữ liệu và tạo lại database:
node reset.js
Server này dùng để tìm kiếm câu trả lời phù hợp nhất từ database.
Chạy:
python semantic_server.py
Server sẽ chạy tại:
http://localhost:3001
Kiểm tra server:
GET /mcp
Kết quả:
{
"status": "MCP server running"
}
Client này kết nối với XiaoZhi Agent thông qua WebSocket.
Chạy:
python mcp_client.py
Chức năng:
Ví dụ log:
✅ Connected: agent_1
[agent_1] Query: Chiến tranh thế giới thứ hai kết thúc khi nào?
⭐ Best score: 0.91
Hệ thống sử dụng model:
sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2
Đây là model embedding đa ngôn ngữ hỗ trợ tiếng Việt.
Độ tương đồng được tính bằng cosine similarity.
Ngưỡng trả lời:
0.80
Nếu độ tương đồng thấp hơn ngưỡng này, chatbot sẽ không trả lời.
Agent sử dụng tool:
search_knowledge
Chức năng:
Tìm kiếm thông tin lịch sử trong cơ sở dữ liệu.
Trong mcp_client.py, thay YOUR_TOKEN bằng TOKEN trong console của Xiaozhi:
wss://api.xiaozhi.me/mcp/?token=YOUR_TOKEN
MIT License
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"xiaozhi-history-mcp": {
"command": "npx",
"args": []
}
}
}