# 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ó)
```bash
# 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
```bash
uv pip install mcp
```
## Cấu hình MCP
Thêm vào file `.kiro/settings/mcp.json`:
```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ị):
```json
{
"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:
```json
{
"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
1. **create_note** - Tạo ghi chú mới
2. **read_note** - Đọc ghi chú theo ID
3. **update_note** - Cập nhật ghi chú
4. **delete_note** - Xóa ghi chú
5. **list_notes** - Liệt kê ghi chú (có thể lọc theo tag)
6. **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