🗒️ AI 便签 – Python 中的 MCP 服务器

这个项目是一个使用 mcp SDK 构建的最小化的 MCP (消息控制协议) 服务器。它允许你创建和管理便签，这些便签可以通过 Claude Desktop 等 AI 代理进行阅读、更新和总结。

🚀 功能

• ✅ 添加并保存便签
• 📖 阅读所有已保存的便签
• 📌 获取最新的便签
• 🧠 提示 Claude 总结所有便签

📦 要求

• Python 3.8+
• 安装 Claude Desktop
• uv（推荐用于依赖管理，优于 pip）
• MCP Python SDK

🛠 设置

1. 安装 uv（推荐）

   # Windows
   irm https://astral.sh/uv/install.ps1 | iex
   
   # macOS/Linux
   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. 初始化新项目

   uv init . |sh
   

3. 安装依赖

   uv add mcp-cli
   

4. 运行 MCP 服务器

   uv run mcp install main.py
   

5. 与 Claude Desktop 集成

   打开 Claude Desktop

   进入设置 > 开发者 > 编辑配置

   使用生成的 uv 命令添加你的 MCP 服务器

   重启 Claude

✨ 使用方法

向 Claude 提问如下：

"添加一条便签，内容是 '下午3点开会'"

"阅读我所有的便签"

"最新的便签是什么？"

"总结我的便签"

🧾 文件结构

  ```bashbash
  main.py          # MCP server implementation
  notes.txt        # Auto-generated file storing notes

📚 使用的工具和概念

• FastMCP
• @mcp.tool – 用于可执行函数
• @mcp.resource – 用于上下文数据（如最新便签）
• @mcp.prompt – 可重用的 AI 代理提示
• Claude Desktop 集成

🧠 未来增强的想法

• 多用户便签支持
• 为便签添加时间戳
• 按关键字搜索便签
• 由 AI 生成的标签或类别