AI便签服务

基于模型上下文协议(MCP)的AI便签服务,支持通过Claude Desktop创建、读取和管理持久化便签。

  • by aymaneELHICHAMI
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 aymaneelhichami/mcp-server-demo

使用说明

mcp服务器演示(AI便利贴)

AI便签:一个模型上下文协议(MCP)应用程序,使Claude Desktop能够创建、读取和管理持久便签。

概述

AI Sticky Notes利用模型上下文协议在Claude Desktop和简单的笔记系统之间提供无缝集成。此实现允许Claude:

  • 将笔记保存到持久存储
  • 检索所有已保存的笔记
  • 访问最近添加的注释
  • 生成提示以总结现有笔记

安装

先决条件

  • Python 3.7+
  • MCP Python SDK
  • Claude桌面应用程序

设置

  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便签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