MCP Notes Server

MCP Notes 服务

用于管理笔记并提供持久化存储的模型上下文协议（MCP）服务实现。

功能

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

安装

通过 Smithery 安装

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

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

手动安装

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

   python -m venv .venv
   
   # On Unix/MacOS:
   source .venv/bin/activate
   
   # On 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. 操作示例：

   # Create a note
   await client.call_tool("add-note", {
       "name": "example",
       "content": "This is a test note"
   })
   
   # List all notes
   await client.call_tool("list-all-notes")
   
   # Update a note
   await client.call_tool("update-note", {
       "name": "example",
       "content": "Updated content"
   })
   
   # Delete a note
   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 操作
• 多笔记处理
• 错误情况
• 资源访问
• 提示词生成

许可证

[在此添加许可证]