笔记管理服务器

个人笔记MCP服务器

用于存储和查询个人笔记的最小教育MCP服务器。

特征

• 内存中的笔记存储（无持久性；重启时数据重置）
• 按以下方式分组的笔记 notebook （例如： diary, exercise)
• 每条注释的字段： id, created_at, title, body, notebook
• 默认笔记本： scrapbook （插入时未提供）
• MCP工具：
  • add_note
  • list_notes
  • list_recent_notes
  • search_notes
  • delete_note
  • move_note

需求

• Python 3.10+

安装

pip install -e .

运行（HTTP）

notes-mcp

可选环境变量：

• NOTES_HOST （默认值： 0.0.0.0)
• NOTES_PORT （默认值： 8000)

工具I/O（JSON）

add_note

输入字段：

• title: string
• body: string
• notebook?: string （可选，默认为 scrapbook)
• created_at?: string （可选，默认为当前UTC）

输出：

• 插入注释对象

list_notes

输入字段：

• notebook?: string
• limit?: int （默认值 100)

输出：

• { "notes": [...], "count": N }

list_recent_notes

输入字段：

• n?: int （默认值 10)

输出：

• { "notes": [...], "count": N }

search_notes

输入字段：

• query: string
• notebook?: string
• limit?: int （默认值 100)

行为：

• 中不区分大小写的子字符串匹配 title 或 body

输出：

• { "notes": [...], "count": N }

delete_note

输入字段：

• note_id: int

输出：

• { "deleted": true/false, "note_id": id }

move_note

输入字段：

• note_id: int
• to_notebook: string

输出：

• 已更新笔记对象

部署笔记

• FastMCP Cloud：部署此仓库并运行 notes-mcp 作为启动命令。
• VM：安装依赖项并运行 notes-mcp 在您首选的流程管理器/反向代理后面。