🧠 Custom MCP Server for AI-Powered Sticky Notes

---

📖 什么是 NoteFlow？

NoteFlow 是一个自定义 MCP（模型上下文协议）服务，旨在将可持久保存的便笺引入 AI 工作流。

用户无需在不同应用中手动管理便笺，只需用自然语言请求 AI 助手创建、保存或检索便笺。

与 Claude Desktop 等 AI 客户端集成后，NoteFlow 可让助手：

• 保存提醒
• 存储想法
• 检索之前保存的便笺
• 在不同对话间保持持久上下文

所有便笺都保存在本地的简单 .txt 文件中，使系统轻量、透明且完全可自定义。

---

✨ 功能

功能	描述
🧠 自定义 MCP 服务	使用 FastMCP 实现功能完整的 MCP 服务
📝 自然语言创建便笺	AI 助手可以直接通过命令添加便笺
📖 检索便笺	即时检索之前保存的便笺
💾 持久化存储	便笺保存在本地 .txt 文件中
⚡ 快速 Python 环境	使用现代化的 uv 包管理器
🔗 Claude Desktop 集成	在 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️⃣ 助手通过 MCP 发送工具请求 3️⃣ FastMCP 服务处理请求 4️⃣ 将便笺写入 notes.txt 或从中检索 5️⃣ 将响应返回给 AI 客户端

此架构让AI 助手能够安全、高效地与本地工具交互。

---

🛠️ 技术栈

核心后端

组件	技术
编程语言	Python 3.12
MCP 服务框架	FastMCP
包管理器	uv
存储	本地 .txt 文件
AI 客户端集成	Claude Desktop

---

📂 项目结构

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+
• Claude Desktop（可选，但推荐）

---

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 Desktop 集成

如果已安装 Claude Desktop：

1️⃣ 运行：

uv run mcp install main.py

2️⃣ Claude 会自动检测你的 MCP 服务。

3️⃣ 如果没有显示工具，请重启 Claude：

• 打开 任务管理器
• 结束 Claude Desktop 进程
• 重启应用

现在应该可以使用你的 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	定义工具和命令
客户端集成	Claude Desktop	自动注册 MCP 服务

---

🐛 已知问题与故障排除

Claude 中看不到 MCP 服务

重启 Claude 桌面应用：

1. 打开 任务管理器
2. 结束 Claude 进程
3. 重启应用

---

笔记未保存

请确保：

• 项目目录中存在 notes.txt
• MCP 服务有权限写入该文件

---

🔮 后续改进

• 📂 笔记标签和分类
• 🧠 使用嵌入进行语义搜索
• 🗑️ 删除或编辑笔记
• ☁️ 集成云存储
• 🔗 多 Agent MCP 工作流

---