Notes MCP Server - Quản lý Ghi chú Cá nhân
MCP Server để quản lý ghi chú cá nhân với AI Agent. Hỗ trợ tạo, đọc, cập nhật, xóa và tìm kiếm ghi chú.
Tính năng
- ✅ Tạo ghi chú mới với tiêu đề, nội dung và tags
- 📖 Đọc ghi chú theo ID
- ✏️ Cập nhật ghi chú hiện có
- 🗑️ Xóa ghi chú
- 📚 Liệt kê tất cả ghi chú (có thể lọc theo tag)
- 🔍 Tìm kiếm ghi chú theo từ khóa
Cài đặt
Yêu cầu
- Python 3.10 trở lên
- uv hoặc pip
Cài đặt uv (nếu chưa có)
# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
Cài đặt dependencies
uv pip install mcp
Cấu hình MCP
Thêm vào file .kiro/settings/mcp.json:
{
"mcpServers": {
"notes-manager": {
"command": "python",
"args": ["notes_mcp_server.py"],
"disabled": false,
"autoApprove": [
"create_note",
"read_note",
"update_note",
"delete_note",
"list_notes",
"search_notes"
]
}
}
}
Hoặc sử dụng uvx (khuyến nghị):
{
"mcpServers": {
"notes-manager": {
"command": "uvx",
"args": ["--from", ".", "notes-mcp-server"],
"disabled": false,
"autoApprove": ["create_note", "read_note", "list_notes", "search_notes"]
}
}
}
Sử dụng
Tạo ghi chú mới
Tạo ghi chú mới với tiêu đề "Ý tưởng dự án" và nội dung "Xây dựng ứng dụng quản lý task"
Đọc ghi chú
Đọc ghi chú có ID 20241201_143000
Liệt kê ghi chú
Liệt kê tất cả ghi chú
Tìm kiếm
Tìm kiếm ghi chú có từ "dự án"
Cập nhật ghi chú
Cập nhật ghi chú 20241201_143000 với nội dung mới
Xóa ghi chú
Xóa ghi chú 20241201_143000
Lưu trữ
Ghi chú được lưu tại: ~/.kiro_notes/
Mỗi ghi chú là một file JSON với cấu trúc:
{
"id": "20241201_143000",
"title": "Tiêu đề",
"content": "Nội dung ghi chú",
"tags": ["tag1", "tag2"],
"created_at": "2024-12-01T14:30:00",
"updated_at": "2024-12-01T14:30:00"
}
Công cụ có sẵn
- create_note - Tạo ghi chú mới
- read_note - Đọc ghi chú theo ID
- update_note - Cập nhật ghi chú
- delete_note - Xóa ghi chú
- list_notes - Liệt kê ghi chú (có thể lọc theo tag)
- search_notes - Tìm kiếm ghi chú
Khắc phục sự cố
Server không kết nối
- Kiểm tra Python đã cài đặt:
python --version - Kiểm tra mcp đã cài:
pip list | grep mcp - Xem log trong MCP Server view của Kiro
Không tìm thấy ghi chú
- Ghi chú được lưu tại
~/.kiro_notes/ - Kiểm tra quyền truy cập thư mục
License
MIT