🧠 NoteFlow
通过自定义MCP服务器使用AI驱动的便签
一个轻量级的模型上下文协议（MCP）服务器，使AI助手能够使用自然语言创建、检索和管理便签。 *将简单的对话转化为持久的笔记，以提高生产力、头脑风暴和提醒。*
    
______________________________________________________________________
📖 什么是NoteFlow？
NoteFlow是一个 自定义MCP（模型上下文协议）服务器 旨在将持久的便签带入人工智能工作流程。
用户可以简单地在单独的应用程序中手动管理笔记，而不是 问他们的人工智能助手 使用自然语言创建、存储或检索笔记。
当与AI客户端集成时，例如 克劳德桌面版，NoteFlow允许助手：
- 保存提醒
- 店铺创意
- 检索以前保存的笔记
- 在对话中保持持久的上下文
所有笔记都存储在本地一个简单的 .txt 文件，使系统 轻便、透明、完全可定制.
______________________________________________________________________
✨ 特性
| 特性 | 描述 |
|---|---|
| 🧠 自定义MCP服务器 | 使用FastMCP实现功能齐全的MCP服务器 |
| 📝 自然语言笔记创建 | AI助手可以直接通过命令添加笔记 |
| 📖 笔记检索 | 立即检索以前保存的笔记 |
| 💾 持久存储 | 笔记存储在本地 .txt 文件 |
| ⚡ 快速Python环境 | 使用现代 uv 包管理器 |
| 🔗 Claude桌面集成 | 在Claude中自动注册工具 |
| 🧩 可扩展设计 | 轻松添加新工具，如删除、标记或分类笔记 |
______________________________________________________________________
🏗️ 系统架构
请求流
graph TD
A[👤 User Prompt] --> B[Claude Desktop AI]
B --> C[MCP Client]
C --> D[Custom MCP Server - FastMCP]
D --> E{Command Type}
E -->|Add Note| F[Write to notes.txt]
E -->|Retrieve Notes| G[Read notes.txt]
E -->|List Notes| H[Parse Stored Notes]
F --> I[Return Confirmation]
G --> I
H --> I
I --> B______________________________________________________________________
MCP工作流程
MCP服务器公开 自定义工具 AI客户端可以调用。
1.️⃣ 用户要求AI助手保存或检索笔记 2.️⃣ 助手通过发送工具请求 主控程序 3.️⃣ 这 FastMCP服务器处理请求 4.️⃣ 笔记被写入或从中检索 notes.txt 5.️⃣ 响应返回给AI客户端
这种架构允许 AI助手可以安全有效地与本地工具进行交互。
______________________________________________________________________
🛠️ 技术栈
核心后端
| 组件 | 技术 |
|---|---|
| 程序设计语言 | Python 3.12 |
| MCP服务器框架 | FastMCP |
| 包管理器 | uv |
| 存储 | 本地 .txt 文件 |
| AI客户端集成 | 克劳德桌面 |
______________________________________________________________________
📂 项目结构
ai-sticky-notes-mcp/
│
├── main.py # MCP server logic (tools, prompts, handlers)
├── notes.txt # Persistent storage for sticky notes
└── README.md # Project documentation______________________________________________________________________
🚀 安装和设置
先决条件
- Python 3.12+
- 克劳德桌面（可选，但推荐）
______________________________________________________________________
1.️⃣ 安装 uv
Windows（PowerShell）
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"Mac/Linux（curl）
curl -LsSf https://astral.sh/uv/install.sh | sh或与 wget
wget -qO- https://astral.sh/uv/install.sh | sh______________________________________________________________________
2.️⃣ 初始化项目
uv init .______________________________________________________________________
3.️⃣ 添加MCP依赖关系
uv add "mcp[cli]"______________________________________________________________________
🏃 运行MCP服务器
将所有服务器逻辑放入其中 main.py.
然后安装MCP服务器：
uv run mcp install main.py这会注册MCP服务器，以便AI客户端可以自动发现它。
______________________________________________________________________
🔗 Claude桌面集成
如果 克劳德桌面版 已安装：
1.️⃣ 运行：
uv run mcp install main.py2.️⃣ Claude将自动检测您的MCP服务器。
3.️⃣ 如果工具未出现，请重新启动Claude：
- 打开 任务管理器
- 结束 克劳德桌面进程
- 重新启动应用程序
您的MCP工具现在应该可用。
______________________________________________________________________
🌐 MCP工具示例
您的服务器可以公开以下工具：
| 工具 | 说明 |
|---|---|
add_note | 保存新的便利贴 |
get_notes | 检索所有笔记 |
search_notes | 查找包含关键字的笔记 |
交互示例：
User: Remember that I need to finish my ML assignment tonight.
Claude: Note saved successfully.______________________________________________________________________
⚙️ 配置
| 设置 | 文件 | 说明 |
|---|---|---|
| 笔记存储 | notes.txt | 存储笔记的本地文件 |
| MCP工具 | main.py | 定义工具和命令 |
| 客户端集成 | 克劳德桌面 | 自动注册MCP服务器 |
______________________________________________________________________
🐛 已知问题和故障排除
MCP服务器在Claude中不可见
重新启动Claude桌面应用程序：
- 打开 任务管理器
- 结束 克劳德过程
- 重新启动应用程序
______________________________________________________________________
笔记未保存
确保：
notes.txt存在于项目目录中- MCP服务器有权写入文件
______________________________________________________________________
🔮 未来改进
- 📂 注意标记和分类
- 🧠 基于嵌入的语义搜索
- 🗑️ 删除或编辑注释
- ☁️ 云存储集成
- 🔗 多代理MCP工作流
______________________________________________________________________
让AI助手记住重要的事情。
NoteFlow --因为想法不应该消失。
