MCP Notes 服务器

一个用于管理具有持久存储功能的笔记的模型上下文协议 (MCP) 服务器实现。

特性

• 创建、读取、更新和删除笔记
• 使用 JSON 进行持久化存储
• 跟踪创建和修改的时间戳
• 通过提示进行笔记摘要
• 使用 note:// URI 方案进行基于资源的访问

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装笔记：

npx -y @smithery/cli install notes --client claude

手动安装

1. 确保已安装 Python 3.10 或更高版本
2. 创建虚拟环境：

   python -m venv .venv
   
   # 在 Unix/MacOS 上：
   source .venv/bin/activate
   
   # 在 Windows 上：
   .venv\Scripts\activate
   

3. 安装依赖项：

   pip install MCP
   

项目结构

notes/
├── __init__.py          # Package initialization
├── server.py           # Main server implementation
├── storage.py          # Note persistence layer
├── resources.py        # Resource handling (note:// URIs)
├── prompts.py         # LLM prompt generation
└── tools/             # Server tools
    ├── __init__.py    # Tools package initialization
    ├── list_tools.py  # Tool listing functionality
    └── handle_tools.py # Tool handling implementation

可用工具

• add-note: 创建新笔记
• list-all-notes: 显示所有存储的笔记
• update-note: 修改现有笔记
• delete-note: 删除笔记

使用方法

1. 启动服务器：

   mcp install src/notes
   mcp start Notes
   

2. 示例操作：

   # 创建笔记
   await client.call_tool("add-note", {
       "name": "example",
       "content": "这是一个测试笔记"
   })
   
   # 列出所有笔记
   await client.call_tool("list-all-notes")
   
   # 更新笔记
   await client.call_tool("update-note", {
       "name": "example",
       "content": "更新后的内容"
   })
   
   # 删除笔记
   await client.call_tool("delete-note", {
       "name": "example"
   })
   

存储

笔记以如下结构存储在 notes_storage.json 中：

{
    "note_name": {
        "content": "Note content",
        "created_at": "2025-01-12T11:28:16.721704",
        "modified_at": "2025-01-12T11:28:16.721704"
    }
}

资源访问

可以使用 note:// URI 方案作为资源访问笔记：

• 列出资源：返回所有可用笔记作为资源
• 读取资源：使用 note://internal/note_name 访问特定笔记

提示生成

服务器包括一个用于笔记摘要的提示生成功能：

• 支持简短和详细摘要
• 格式化笔记以适应语言模型输入
• 通过 "summarize-notes" 提示可用

开发

要修改或扩展服务器：

1. 克隆仓库
2. 安装开发依赖项
3. 在适当的模块中进行更改
4. 在部署前彻底测试

测试

测试应覆盖：

• 基本 CRUD 操作
• 多个笔记处理
• 错误情况
• 资源访问
• 提示生成

许可证

[在此处添加您的许可证]