使用说明
mcp服务器演示(AI便利贴)
AI便签:一个模型上下文协议(MCP)应用程序,使Claude Desktop能够创建、读取和管理持久便签。
概述
AI Sticky Notes利用模型上下文协议在Claude Desktop和简单的笔记系统之间提供无缝集成。此实现允许Claude:
- 将笔记保存到持久存储
- 检索所有已保存的笔记
- 访问最近添加的注释
- 生成提示以总结现有笔记
安装
先决条件
- Python 3.7+
- MCP Python SDK
- Claude桌面应用程序
设置
-
克隆此存储库:
git clone https://github.com/aymaneELHICHAMI/mcp-server-demo.gitcd mcp-server-demo
-
安装
uv- 文档:https://docs.astral.sh/uv/getting-started/installation/
-
创建虚拟环境
uv venv venv
-
激活虚拟环境
uv venv
-
从安装依赖项
uv.lockuv sync
-
运行MCP服务器
uv run mcp install main.py如果配置未反映在Claude Desktop中(菜单栏->设置->开发人员),请尝试从任务管理器强制关闭Claude Desktop并重新打开它。工作时,您应该看到“AI便签MCP服务器”正在运行。
核心组件
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("AI Sticky Notes")
该服务器在MCP生态系统中注册为“AI便签”,使其可被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桌面文档:https://docs.anthropic.com/en/docs/welcome