🧠 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的互动示例
你:“添加一条注释,说明‘安排与团队会面’。” 克劳德:“笔记保存了!”
你:“给我看所有的笔记。” 克劳德:
- 周一前完成项目报告。
- 安排与团队会面。
你:“总结我的笔记。” 克劳德:“你有两项任务:完成项目报告和安排团队会议。”
🪶 文件详细信息 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客户端为例
