AI Summarizer + MCP (Windows Desktop)
Ứng dụng desktop chạy nền (system tray) cho Windows:
- Bôi đen văn bản → Shift + chuột phải → panel hành động.
- Gọi LLM cục bộ (Ollama hoặc LM Studio) để tóm tắt/giải thích/dịch.
- Tích hợp MCP: chọn server/tool, chạy tool (filesystem, web, DB…), lấy kết quả làm ngữ cảnh trước khi tóm tắt.
Tính năng
- Chat Window: Chat với AI, hỗ trợ lịch sử hội thoại và tích hợp MCP tools thủ công.
- Popup hành động cạnh con trỏ: Tóm tắt, Giải thích, Dịch, Viết lại, Prompt tuỳ biến.
- Provider: Ollama (
/api/generate&/api/chat) hoặc LM Studio (OpenAI-compatible/v1/chat/completions). - MCP Panel: liệt kê servers/tools, nhập args JSON, chạy tool và chèn kết quả vào prompt/chat.
- Bảo mật: Mặc định chỉ gọi endpoint local và MCP servers cục bộ.
Yêu cầu hệ thống
- Windows 10/11
- Python 3.10+ (khuyến nghị 64-bit)
- Node.js (để chạy MCP filesystem server qua
npx)
Cài đặt
# 1) Tạo venv và cài thư viện
python -m venv .venv
.venv\Scripts\activate
pip install PySide6 pynput pywin32 requests "mcp[cli]" python-dotenv
# 2) (Tuỳ chọn) Đóng gói .exe
pip install pyinstaller
pyinstaller -F -w app.pyGợi ý model cục bộ (máy i7-14700K, RAM 64GB):llama3.2:3b-instruct,mistral:7b-instruct(Q4),phi3.1:3.8b. Ollama nhanh & đơn giản.
Cấu hình
Lần chạy đầu sẽ tạo config.json. Bạn có thể sửa qua menu Cấu hình… hoặc trực tiếp file.
{
"provider": "ollama",
"ollama": {
"endpoint": "http://127.0.0.1:11434",
"model": "llama3.2:3b-instruct",
"temperature": 0.2,
"max_tokens": 1024
},
"lmstudio": {
"endpoint": "http://127.0.0.1:1234/v1",
"model": "Meta-Llama-3.1-8B-Instruct-Q4_K_M",
"temperature": 0.2,
"max_tokens": 1024
},
"ui": {
"summary_language": "vi",
"trigger": {"modifier": "shift", "button": "right"}
},
"mcp": {
"enabled": true,
"servers": [
{
"name": "filesystem",
"command": "npx",
"args": ["@modelcontextprotocol/server-filesystem"],
"env": {"ROOT_PATH": "C:/Users/YourUser/Documents"}
}
]
}
}Lưu ý: Dùng forward slash/hoặc escape backslash\\trong JSON đường dẫn.
Chạy providers
Ollama
# Cài và chạy server
# https://ollama.com
ollama serve
ollama pull llama3.2:3b-instructLM Studio
- Mở LM Studio → Tab Server → chọn model → Start Server (mặc định
http://127.0.0.1:1234/v1).
Chạy MCP servers
Ví dụ Filesystem server qua npx (Node.js):
- Ứng dụng sẽ tự khởi chạy server qua cấu hình stdio.
- Bạn có thể thay
ROOT_PATHđể giới hạn phạm vi đọc/ghi.
Sử dụng
- Chạy
python app.py(hoặc mởdist/app.exe). - Biểu tượng máy tính xuất hiện ở system tray.
- Bôi đen văn bản → giữ Shift → Click chuột phải.
- Chọn hành động: Tóm tắt / Giải thích / Dịch / Viết lại / Prompt.
- Để thêm ngữ cảnh từ MCP:
- Mở menu tray → MCP: Panel chọn server/tool. - Chọn server, tool, nhập args JSON → Chạy tool. - Tick “Dùng kết quả làm ngữ cảnh tóm tắt” → Đóng. - Thực hiện tóm tắt như bước 3–4.
- Sử dụng Chat Window:
- Mở menu tray (chuột trái hoặc phải) → chọn 💬 Mở Chat. - Chat bình thường với AI. - Để dùng MCP tools: - Click nút 📎 MCP Tools trong cửa sổ chat. - Chọn tool và chạy → kết quả sẽ tự động thêm vào đoạn chat dưới dạng "Tool Result". - AI sẽ dùng thông tin đó để trả lời câu hỏi tiếp theo của bạn. - Các tính năng khác: Clear history, Export chat to .txt.
Đóng gói .exe
pyinstaller -F -w app.py
# File tạo tại dist/app.exeThư mục dự án
ai_summarizer_mcp/
├─ app.py
├─ README.md
├─ requirements.txt
└─ (tự sinh) config.json sau lần chạy đầuTroubleshooting
- Không copy được selection: Một số app chặn
Ctrl+C. Hãy nhấnCtrl+Cthủ công trước rồi dùng gesture. - Ollama 404/timeout: Kiểm tra
ollama servevà model đãpull. - MCP server không hiện tools: Kiểm tra Node.js, thử chạy thủ công
npx @modelcontextprotocol/server-filesystem. - LM Studio trả lỗi: Đảm bảo endpoint
/v1và model đúng tên.
Ghi chú & chuẩn MCP
- MCP là chuẩn mở (Anthropic) cho tools/resources/prompts; SDK Python hỗ trợ client–server và stdio/HTTP/SSE transport.
- Tham khảo: Model Context Protocol Python SDK & hướng dẫn Build an MCP client.