AI Sticky Notes MCP Server

AI 便签 MCP 服务

一个基于模型上下文协议（MCP）构建的简易记事系统，可让 AI 助手创建、读取和总结笔记。

概述

本项目实现了一个轻量级记事系统，展示了 MCP 的核心概念，并提供以下功能：

• 向中央存储库添加新笔记
• 读取所有现有笔记
• 访问最新笔记
• 为已存储的笔记生成 AI 摘要

该服务使用 FastMCP 构建，可轻松集成到 Claude Desktop 或 Cursor 等 AI 助手中。

先决条件

• Python 3.8+
• uv 包管理器（https://github.com/astral-sh/uv）
• Claude Desktop（用于搭配 Claude 使用）
• Cursor IDE（用于搭配 Cursor 的 AI 助手使用）

安装

克隆代码库

git clone https://github.com/pi-prakhar/mcp-server-demo.git
cd mcp-server-demo

安装依赖项

本项目使用 pyproject.toml 文件，并通过 uv 管理依赖项。使用以下命令安装依赖项：

# Install dependencies using uv
uv pip install -e .

运行服务

用于开发和测试：

uv run mcp dev main.py

将服务安装到 Claude Desktop：

uv run mcp install main.py

连接到 Claude Desktop

自动设置

运行安装命令后，你可以自动设置 Claude Desktop：

mcp setup --app Claude

手动设置

或者，编辑 Claude Desktop 配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

将以下内容添加到配置文件中：

{
  "mcpServers": {
    "Demo": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/full/path/to/your/main.py"
      ]
    }
  }
}

**注意：**如果 Claude 报告找不到 uv 命令，请使用 uv 可执行文件的完整路径。查找完整路径的方法：

# 在 macOS/Linux 上
which uv

# 在 Windows（命令提示符）上
where uv

# 在 Windows（PowerShell）上
Get-Command uv | Select-Object -ExpandProperty Source

然后在配置中使用完整路径：

{
 "mcpServers": {
   "Demo": {
     "command": "/full/path/to/your/uv",
     "args": [
       "run",
       "--with",
       "mcp[cli]",
       "mcp",
       "run",
       "/full/path/to/your/main.py"
     ]
   }
 }
}

或者，你可以在 PATH 中的目录里创建指向 uv 的符号链接：

# 在 macOS/Linux 上
sudo ln -s /path/to/your/uv /usr/local/bin/uv

# 在 Windows 上（以管理员身份运行命令提示符）
mklink C:\Windows\System32\uv.exe C:\path\to\your\uv.exe

完成设置

1. 更新配置文件后，重启 Claude Desktop
2. 你应该能在输入框右下角看到一个锤子图标
3. 点击锤子图标，确认 AI Sticky Notes 工具可用

与 Cursor 集成

全局设置

1. 打开 Cursor IDE
2. 前往 Cursor Settings > Features > MCP
3. 点击 + Add New MCP Server 按钮
4. 填写表单：
   • 类型：选择 stdio 作为传输方式
   • 名称：输入 ai-sticky-notes 或其他描述性名称
   • 命令：输入运行服务的完整命令：

     uv run --with mcp[cli] mcp run /full/path/to/your/main.py
     

5. 点击 Add
6. 你可能需要点击刷新按钮以加载工具列表

项目专属设置

或者，为特定项目进行设置：

1. 在项目目录中创建 .cursor/mcp.json 文件，内容如下：

   {
     "mcpServers": {
       "ai-sticky-notes": {
         "command": "uv",
         "command": "uv",
         "args": [
           "run",
           "--with",
           "mcp[cli]",
           "mcp",
           "run",
           "/full/path/to/your/main.py"
         ]
       }
     }
   }
   

重要说明

• 资源限制：Cursor 目前仅支持 MCP 工具，不支持资源。这意味着 Cursor 中无法使用 notes://latest 资源。
• 工具审批：默认情况下，Cursor 会在运行任何 MCP 工具前征求你的批准。你可以在设置中启用“Yolo 模式”，以允许自动执行。
• 工具使用：Agent 会在相关情况下自动使用 MCP 工具。你也可以通过提及工具名称或描述，来指定使用某个工具。

功能

工具

• add_note - 向笔记文件追加新笔记
• read_notes - 读取并返回笔记文件中的所有笔记

资源

• notes://latest - 获取 notes 文件中的最新笔记

提示词

• note_summary_prompt - 生成当前笔记的摘要

使用示例

连接到 Claude 或 Cursor 的 AI 助手后，你可以使用自然语言与笔记系统交互：

User: Add a reminder to buy groceries tomorrow
AI: I'll add that note for you.
    [Uses add_note tool]
    Note added successfully!

User: What notes do I currently have?

AI: Let me check your notes:
    [Uses read_notes tool]
    - Buy groceries: milk, eggs, bread
    - Call dentist to reschedule appointment
    - Meeting with team at 3pm tomorrow

User: What was the most recent note I added?

AI: Your most recent note is:
    [Uses notes://latest resource]
    Meeting with team at 3pm tomorrow

User: Can you summarize all my notes?

AI: [Uses note_summary_prompt]
    Your notes contain reminders about shopping for basic groceries (milk, eggs, bread), 
    calling the dentist to change your appointment time, and an upcoming team meeting 
    scheduled for tomorrow at 3pm.

项目结构

• main.py - 包含工具定义的 MCP 服务主实现
• notes.txt - 存储笔记的文件

自定义

你可以修改 main.py 中的 NOTES_FILE 路径来更改笔记的存储位置。

调试

由于 MCP 服务通过 stdio 通信，调试可能颇具挑战。MCP 开发模式会提供有用的调试信息：

uv run mcp dev main.py