# 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