mcp-server-demo (AI sticky notes)

mcp-server-demo（AI 便笺）

AI 便笺：一种模型上下文协议（MCP）应用，可让 Claude Desktop 创建、读取和管理持久化便笺。

概述

AI 便笺利用模型上下文协议，在 Claude Desktop 与简单的记事系统之间实现无缝集成。此实现可让 Claude：

• 将便笺保存到持久化存储中
• 获取所有已保存的便笺
• 访问最近添加的便笺
• 生成用于总结现有便笺的提示词

安装

先决条件

• Python 3.7+
• MCP Python SDK
• Claude Desktop 应用程序

设置

1. 克隆此代码库：

   • git clone https://github.com/aymaneELHICHAMI/mcp-server-demo.git
   • cd mcp-server-demo

2. 安装 uv

   • 文档：https://docs.astral.sh/uv/getting-started/installation/

3. 创建虚拟环境

   • uv venv venv

4. 激活虚拟环境

   • uv venv

5. 从 uv.lock 安装依赖项

   • uv sync

6. 运行 MCP 服务

   • uv run mcp install main.py 如果配置未在 Claude Desktop 中生效（菜单栏 -> 设置 -> 开发者），请尝试通过任务管理器强制关闭 Claude Desktop，然后重新打开。运行正常时，你应该会看到“AI Sticky Notes MCP Server”正在运行。

核心组件

from mcp.server.fastmcp import FastMCP
mcp = FastMCP("AI Sticky Notes")

该服务在 MCP 生态系统中注册为“AI Sticky Notes”，使 Claude Desktop 等客户端能够发现它。

便笺存储在简单的文本文件（notes.txt）中，每条便笺单独占一行。如果文件不存在，系统会自动创建。

该服务提供以下 MCP 功能：

类型	名称	描述
工具	add_note	向存储中追加一条新便笺
工具	read_notes	获取所有现有便笺
资源	notes://latest	访问最近的便笺
提示词	note_summary_prompt	生成用于总结便笺的提示词

与 Claude Desktop 搭配使用

服务运行后，Claude Desktop 会自动发现并连接到它。你可以通过自然语言与便笺交互：

You: "Please save this as a note: Remember to schedule a team meeting for Friday"
Claude: [Uses add_note tool] "Note saved!"

You: "What notes do I have?"
Claude: [Uses read_notes tool] "Here are your notes: ..."

You: "What was my most recent note?"
Claude: [Accesses notes://latest resource] "Your most recent note is: ..."

You: "Can you summarize my notes?"
Claude: [Uses note_summary_prompt] "Here's a summary of your notes: ..."

资源

• 模型上下文协议文档：https://modelcontextprotocol.io/introduction

• FastMCP API 参考：https://github.com/jlowin/fastmcp

• Claude Desktop 文档：https://docs.anthropic.com/en/docs/welcome