Sticky Note Mcp Server

AI Sticky Notes MCP 服务

此演示展示了一个使用 FastMCP 构建的功能更丰富的模型上下文协议服务。它将简单的便笺列表转换为结构化的笔记系统，并提供标签、置顶、归档和摘要辅助功能。

功能

• 结构化存储，并自动从旧版 notes.txt 文件迁移数据。
• 提供用于创建、列出、搜索、更新、删除和批量清除笔记的工具。
• 每条笔记都可选择设置标签、置顶状态和归档标记。
• 提供可展示最新笔记、置顶笔记和汇总统计数据的资源。
• 提供用于总结笔记或根据特定标签生成路线图的提示词模板。

使用此 MCP 服务可以做什么

此服务可以：

• 创建笔记，为重要事项添加标签并设为置顶
• 列出和筛选笔记，筛选条件包括标签、置顶状态或归档状态
• 搜索笔记内容和标签，以查找特定信息
• 更新现有笔记，修改其内容、标签或状态
• 删除单条笔记，或批量清除所有笔记／归档笔记
• 置顶重要笔记，让它们在摘要中更加醒目
• 归档已完成或过时的笔记，同时保留它们
• 使用 AI 提示词生成摘要，总结活跃笔记
• 根据带标签的笔记创建路线图，规划项目或任务
• 查看统计数据，了解笔记总数、活跃数、归档数和置顶数
• 通过资源获取最新笔记或所有置顶笔记

可用的 MCP 接口

工具

• add_note(message, tags=None, pinned=False) – 创建一条新笔记，可选择添加标签（以逗号分隔）并设为置顶
• read_notes(include_archived=False) – 获取所有笔记，并按创建日期排序（最新的在前）
• list_notes(limit=20, offset=0, tag=None, pinned_only=False, include_archived=False) – 分页列出笔记并进行筛选
• search_notes(query, include_archived=False) – 查找消息内容或标签中包含查询文本的笔记
• update_note(note_id, message=None, tags=None, pinned=None, archived=None) – 修改现有笔记的内容或元数据
• delete_note(note_id) – 永久删除指定笔记
• clear_notes(archived_only=False) – 删除所有笔记，或仅删除归档笔记

每个工具都会返回结构化 JSON，调用工具的客户端可以同时显示笔记元数据和原始消息。

资源

• notes://latest – 最新一条活跃笔记的文本。
• notes://pinned – 以换行符分隔的置顶笔记及其标识符。
• notes://stats – 笔记总数、活跃数、归档数和置顶数。

提示词

• note_summary_prompt() – 要求 AI 总结所有活跃笔记，并突出显示置顶笔记
• note_roadmap_prompt(target_tag=None) – 要求 AI 将匹配的笔记整理成优先级路线图（可选择按标签筛选）

示例用例

1. 个人任务管理：将紧急任务设为置顶，按项目添加标签，并归档已完成事项
2. 头脑风暴：快速记录想法并添加标签，然后使用路线图提示词整理这些想法
3. 会议笔记：使用会议标签保存讨论要点，之后按关键字搜索
4. 学习跟踪：保存学习资源或技巧，按主题标签整理
5. 项目规划：为功能或 Bug 创建笔记，按标签筛选并生成路线图
6. 每日记录：记录一天中的随想，并在一天结束时使用 AI 进行总结

运行服务

激活环境并启动 MCP 服务 CLI：

uv run mcp dev ./main.py

在另一个兼容 MCP 的客户端中，指定生成的清单，或直接调用此服务提供的工具、资源和提示词。