MCP 笔记服务器

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

<a href="https://glama.ai/mcp/servers/tg4ugmp8jr"><img width="380" height="200" src="https://glama.ai/mcp/servers/tg4ugmp8jr/badge" alt="Notes Server MCP server" /></a>

功能

• 创建、读取、更新和删除笔记
• 使用 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          # 包初始化
├── server.py           # 主要服务器实现
├── storage.py          # 笔记持久层
├── resources.py        # 资源处理 (note:// URIs)
├── prompts.py         # LLM 提示生成
└── tools/             # 服务器工具
    ├── __init__.py    # 工具包初始化
    ├── list_tools.py  # 工具列表功能
    └── handle_tools.py # 工具处理实现

可用工具

• 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": "This is a test note"
   })
   
   # 列出所有笔记
   await client.call_tool("list-all-notes")
   
   # 更新一个笔记
   await client.call_tool("update-note", {
       "name": "example",
       "content": "Updated 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 操作
• 多笔记处理
• 错误情况
• 资源访问
• 提示生成

许可证

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