使用说明

🧠 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.py

2.️⃣ 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 --因为想法不应该消失。