AI Sticky Notes MCP Server

AI便签MCP服务器

一个简单而强大的模型上下文协议（MCP）服务器，为AI助手提供持久的便签功能。该服务器允许AI模型创建、读取和管理在对话中持续存在的笔记。

特性

• 持久注释：笔记存储在本地文本文件中，并在会话之间保持不变
• 简单API：易于使用的添加和阅读笔记的工具
• 最新笔记访问：用于快速访问最新笔记的资源端点
• 智能摘要：内置提示，让AI总结所有当前笔记
• 自动初始化：如果笔记文件不存在，则自动创建笔记文件

安装

先决条件

• Python 3.7+
• fastmcp 图书馆

设置

1. 克隆存储库：

   git clone https://github.com/naakaarafr/AI-Sticky-Notes-MCP-Server.git
   cd AI-Sticky-Notes-MCP-Server

1. 安装所需的依赖关系：

   pip install fastmcp

1. 运行服务器：

   python main.py

用法

可用工具

add_note(message: str)

将新便笺附加到便签文件。

参数：

• message （str）：要添加的注释内容

退货：

• 确认信息：“笔记已保存！”

例子：

add_note("Remember to buy groceries tomorrow")
# Returns: "Note saved!"

read_notes()

从便签文件中检索所有便签。

退货：

• 所有音符作为一个字符串，用换行符分隔
• “还没有笔记。”如果没有笔记

例子：

read_notes()
# Returns: "Remember to buy groceries tomorrow\nCall dentist for appointment\nFinish project report"

可用资源

notes://latest

提供对最近添加的注释的快速访问。

退货：

• 最后一条注释条目
• “还没有笔记。”如果没有笔记

可用提示

note_summary_prompt()

生成提示，要求AI汇总所有当前笔记。

退货：

• 包含所有摘要注释的格式化提示字符串
• “还没有笔记。”如果没有笔记

文件结构

project-directory/
├── main.py          # Main MCP server implementation
├── notes.txt        # Persistent storage file (auto-created)
└── README.md        # This file

运作原理

1. 文件管理：服务器自动创建 notes.txt 文件与位于同一目录中 main.py 如果它不存在
2. 钞票存储：每个注释在文本文件中都存储为单独的一行
3. 持久性：服务器重启和AI对话会话之间会保留注释
4. MCP集成：服务器公开了AI模型可以无缝使用的工具、资源和提示

与AI助手集成

此MCP服务器旨在与支持模型上下文协议的AI助手配合使用。一旦连接，AI可以：

• 保存重要信息以供以后参考
• 在多个对话中保持上下文
• 创建待办事项列表和提醒
• 存储研究结果或见解
• 跟踪正在进行的项目

示例用例

个人助理

AI: "I'll add that to your notes."
add_note("Meeting with Sarah on Friday at 2 PM")

研究助理

AI: "Let me save this key finding."
add_note("Study shows 40% improvement in efficiency with new method")

项目管理

AI: "I'll note this task for your project."
add_note("TODO: Review and update project timeline by end of week")

技术细节

• 框架：使用FastMCP构建，便于创建MCP服务器
• 存储：简单的文本文件存储，实现最大兼容性
• 错误处理：包括文件存在检查和优雅的错误处理
• 演出：轻量级实现，依赖性最小

定制

您可以通过以下方式轻松自定义此服务器：

1. 更改存储位置：修改 NOTES_FILE 路径
2. 添加注释类别：扩展 add_note 功能包括类别
3. 实施搜索：添加一个新工具来搜索笔记
4. 添加时间戳：修改注释以包含创建时间戳
5. 执行注释删除：添加工具以删除特定注释

故障排除

常见问题

文件权限错误

• 确保脚本在其目录中具有写入权限
• 检查目录是否存在并且可以访问

导入错误

• 核实一下 fastmcp 已安装： pip install fastmcp
• 确保你使用的是Python 3.7或更高版本

笔记不持久

• 检查一下 notes.txt 正在预期位置创建
• 验证文件写入权限

贡献

这是一个简单的实现，可以通过多种方式进行扩展。我们欢迎捐款！一些想法：

• 添加注释类别或标签
• 实现笔记搜索功能
• 添加注释删除功能
• 包括笔记的时间戳
• 创建用于笔记管理的web界面
• 添加注释导出功能（JSON、CSV等）

请随时：

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 提交拉取请求

对于重大更改，请先打开一个问题来讨论您想要更改的内容。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

支持

有关此MCP服务器的问题或疑问，请：

• 在以下位置创建问题
• 查看FastMCP文档，了解MCP的一般问题