MCP 服务器

Notes MCP Server

Personal note management server that enables creating, reading, updating, deleting, listing, and searching notes with support for titles, content, and tags.

README

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"
}