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

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