AI便签服务器

一个基于FastMCP框架的轻量级MCP服务器,用于存储和管理AI模型生成的便签,支持添加、读取、获取最新便签及生成摘要功能。

  • by Subhokkhon
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Subhokkhon/AI-Sticky-Notes-Custom-MCP-server

使用说明

🧠 AI便签–自定义MCP服务器

此存储库包含使用fastmcp构建的自定义MCP(模型上下文协议)服务器 --一个轻量级的Python库,用于快速创建MCP服务器。

该服务器名为“AI便签”,允许AI模型(如Claude或其他兼容MCP的客户端**):

添加新笔记

阅读现有笔记

检索最新笔记

生成所有笔记的摘要

所有笔记都持久存储在名为notes.txt的本地文件中。

🗂️ 存储库结构 AI贴纸/ │ ├── main.py#主MCP服务器逻辑 ├── notes.txt#存储所有笔记的文件 └── README.md#文档(此文件)

⚙️ 特性 📝 1.添加注释

将新注释(字符串)添加到notes.txt。

函数:add_note(消息:str)

返回:“笔记已保存!”

📖 2.阅读所有笔记

读取并返回所有存储的笔记。

函数:read_notes()

返回:所有笔记的连接字符串,如果为空,则返回“暂无笔记”。

📌 3.获取最新笔记

检索最近添加的注释。

资源URI:notes://latest

返回:最新笔记或“暂无笔记”。如果不存在笔记。

🧾 4.生成摘要提示

使用AI客户端创建用于总结所有笔记的自然语言提示。

函数:note_summary_prompt()

退货:

“总结当前笔记:[内容]”

“还没有笔记。”如果为空

🧩 运作原理

服务器使用FastMCP框架定义模型上下文协议接口。

它公开了任何支持MCP的AI模型(如Claude)都可以使用的工具和资源。

当模型调用add_note或read_notes等函数时,FastMCP会处理交互并相应地更新notes.txt

如果您的MCP兼容客户端(如Claude Desktop)设置正确,它将检测到服务器并将其显示为“AI便签”。

重启克劳德。

现在,您可以使用以下命令:

“添加一条注释,说明‘周一前完成项目报告’。”

“给我看看我所有的笔记。”

“总结我的笔记。”

“我最后加的是什么?”

🧠 与Claude的互动示例

你:“添加一条注释,说明‘安排与团队会面’。” 克劳德:“笔记保存了!”

你:“给我看所有的笔记。” 克劳德:

  1. 周一前完成项目报告。
  2. 安排与团队会面。

你:“总结我的笔记。” 克劳德:“你有两项任务:完成项目报告和安排团队会议。”

🪶 文件详细信息 main.py

实施:

MCP服务器初始化

工具(@mcp.tool)

资源(@mcp.Resource)

提示(@mcp.Prompt)

使用辅助函数ensure_file()确保notes.txt文件存在。

notes.txt

用于存储所有笔记的纯文本文件。每张钞票都存储在单独的行中。

🧰 使用的技术

Python 3.8+

FastMCP——用于构建MCP服务器

模型上下文协议(MCP)——用于与AI模型通信

Claude AI——以MCP客户端为例